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Honestly, it’s not that difficult to take advantage 
of a 13 billion dollar company. 

Any software developer can do it. Especially when it 
comes to Microsoft. We confess, however, that our 
generosity toward developers is not entirely selfless. 
We believe our continued success depends entirely on 
yours. Develop to the Microsoft" Windows" platform and 
you get access to a whole spectrum of free programs. 
Take MSDN™ Online. It’s a collection of downloads, tools, 
technologies, education and information that’s available 
free on the web. Then there’s the Site Builder Network. 
Same deal as MSDN, only for those unique individuals 
known as web developers. Both programs offer you plenty 
of opportunity to take advantage of your friendly, neighbor¬ 
hood software giant. Now who’d want to pass that up? 

To find out how to get with the programs, 
go to www.microsoft.com/msdn/ 


© 1998 Microsoft Corporation. All rights reserved. Microsoft, MSDN, Where do you want to go today?, and Windows are either registered trademarks or trademarks of Microsoft Corporation in the 
United States and/or other countries. 




Microsoft 

Where do you want to go today?® 
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COMPOSING REACTIVE ANIMATIONS 

by Conal Elliott 

Fran, short for “functional reactive animation,” is a high-level vocabulary that lets you 
describe the essential nature of an animated model, while omitting details of 
presentation. 

A CONVERSATION WITH JOHN KNOLL 

by Thomas “Rick” Tewell 

As a visual-effects supervisor for Industrial Light & Magic, John Knoll lives on the 
bleeding-edge of computer graphics. With his brother Tom, he also created the 
Photoshop image-processing software. 

A WINDOWS 3D MODEL VIEWER FOR OPENGL 

by Jawed Karim 

Combining Win32 with OpenGL can lead to some impressive 3D graphics. Jawed 
presents a model viewer for use with OpenGL on Windows 93/NT. 

THE KERNEL GRAPHICS INTERFACE 

by Andreas Beck 

The General Graphics Interface (GGI) project brings safe, fast, and portable graphics to 
a variety of platforms and operating systems. Andreas describes KGI, the kernel-level 
component of the Linux version of GGI. 

AFFINE TEXTURE MAPPING 

by Andre LaMothe 

Affine texture mapping is fundamental to many forms of 3D rendering, including light 
interpolation and other sampling type operations. 

INSIDE DVD 

by Linden deCarmo 

Although DVDs physically resemble CD-ROMs, they store up to 25 times more data. 
Linden focuses on the DVD-Video specification, and presents a DVD-Video player. 
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64 Photography by Sean Casey courtesy of 
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EMBEDDED SYSTEMS 


68HC05-RASED PERIPHERAL DEVICES: RLRT II 72 

by Derrick B. Forte and Hai T. Nguyen 

In this two-part article, our authors design a Windows 95-based Caller ID peripheral 
device built around Motorola’s MC68HC(7)05P9 microcontroller. This month, they 
present the software. 

INTERNET PROGRAMMING 


RENDERING XML DOCUMENTS USING XSL 82 

by Sean McGrath 

Responsibility for rendering XML belongs to the extensible Style Language (XSL) 

Standard. Sean presents an overview of XSL and illustrates how it can be used with 
MSXSL, Microsoft’s XSL implementation. 
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PROGRAMMER'S TOOLCHEST _ 

EXAMINING THE DRAGON SPEECH-RECOGNITION SYSTEM 84 

by Al Williams 

Al uses Visual Basic 5 and Dragon Systems’ DragonXTools toolkit to build a voice- 
activated autodialer. Since the custom controls are ActiveX controls, however, you can 
use most any language. 

JDBC DRIVERS AND WEB SECURITY 90 

by Mukul Sood 

Although security is not officially part of the Java Database Connectivity ODBC) 
specification, JDBC driver vendors are beginning to offer security features such as 
encryption and authentication. 



FORUM 


COLUMNS 


EDITORIAL 

by Jonathan Erickson 


PROGRAMMING PARADIGMS 101 

by Michael Swaine 

Michael ventures into the land of the lizards before adding his two cents to LEO lore. He 
then introduces a new “Paradigms Past” feature. 


LETTERS 

by you 

NEWS & VIEWS 

by the DDJ staff 


C PROGRAMMING 105 

by Al Stevens 

Al continues his journey into the mysteries of Windows CE— and the Windows CE 
Developers Conference has given him a lot to think about. 


OF INTEREST 

by Eugene Eric Kim 
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JAVA Q&A 109 

by Aaron Michael Cohen 

The Java API defines an abstract imaging model that can be used to display and 
manipulate both static images and sequences of images. Aaron examines this powerful 
yet flexible model. 


ALGORITHM ALLEY 115 

by Lee Kamentsky 

Many image-analysis tasks must first separate the image into clearly defined regions. 

Lee’s algorithm performs such a separation and presents the results in a fashion 
amenable to further study. 


DR. ECCO’SOMNIHEURIST CORNER 123 

by Dennis E. Shasha 

Dr. Ecco and his sidekick Liane help the military avoid going from the frying pan into 
lines of fire in this month’s episode. 


PROGRAMMER’S BOOKSHELF 127 

by Gregory V Wilson 

Greg looks at a bevy of books this month, including Software Visualization , C/C++ 

Software Quality Tools, Perl: The Programmer’s Companion, Effective Perl Programming, 

Perl 5 Interactive Course, and Software Runaways: Monumental Software Disasters. 


RESOURCE CENTER 


As a service to our readers, source code (and related 
files), back-referenced articles, and relevant links 
are available electronically at this month’s online 
Table of Contents at http://www.ddj.com/. Source 
code is also available via anonymous FTP from 
ftp.ddj.com (199-125.85.76), the DDJ Forum on 
CompuServe (type GO DDJ), and DDJ Online (650- 
358-8857,14.4 kbps, 8-N-l). Source-code diskettes 
can be ordered ($14.95, California residents add 
sales tax) by mail, fax (650-358-9749), or phone 
(650-655-4100 x5701). Letters to the editor and article 
proposals/submissions should be mailed or faxed 
to the DDJ office or sent electronically to 
editors@ddj.com. Author guidelines are available 
at http://www.ddj.com/. Send inquiries or requests 
to Dr. Dobb’sJournal, 411 Borel Ave., San Mateo, 
CA 94402. For subscription questions (including 
change of address), call 800-456-1215 (U.S. and 
Canada); other countries, call 303-678-0439 or 
fax 303-661-1885. E-mail subscription questions to 
71572.34l@compuserve.com or write to Dr. Dobb’s 
Journal, P.O. Box 56188, Boulder, CO 80322-6188. 


NEXT MONTH 

August brings our annual C++ 
programming issue. 
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Speed is essential in all database projects, but not at the expense of stability. You 
wouldn’t try to go 1 □□ miles per hour with your bicycle! The same is true in database 
technology. FairCom has been delivering fast, safe, full-featured database engines to 
the commercial marketplace for 19 years. Proven on large Unix servers and 
workstations, c-tree Plus’s small footprint and exceptional performance has also 
made it the engine of choice for serious commercial developers on Windows and 
Mac. Che ck out www.faircom.com for detailed information. You’ll be glad you did. 

c _ tree p| us ® features for $ 895 : 


Platforms: 


Royalty Free 

- Portable Multi-Threaded API 

- Complete C Source 

- Thread Safe Libraries 

- Standalone or Client/Server 

- Complete Transaction Processing, 
including automatic recovery 

- Save-points 

- Abort/Commit 


Roll-forwards /Roll-backwards 

• Easy make system 

• Advanced Variable Length Records 

■ BLOBS 

■ Space Management 
File Level Security 
Conditional Index 
ODBC/Java Interfaces 

Over 25 Developer Servers included 


MIPS ABI 
880PEN 
AIX 

RS/6000 


DEC Alpha 
OSF/1 
HP9000 
Sun OS 


Sun SPARC 
DOS 
OS/2 
Mac 


Windows 95 
Windows NT 
Windows 3.1 
Interactive Unix 


SCO Banyan VINES 

LinUX [Alpha/Sparc/Intel) QNX 
AT&T System V Chorus 
Netware NLM Lynx 


j® 




EVELOPMENT SYSTEM 


Half of your Client/Server project is the Server! You control 7 00% of your Client 
Side. Why settle for less on your Server side? Move your functions to the server- 
side to decrease network traffic and increase performance! 


Today’s database demands may often be too complex for traditional Relational Model 
Database Servers. Server needs come in many different sizes and shapes. What 
better way to accommodate these requirements than by allowing the developer to 
take full control of the Server side? FairCom’s Server Development System was 
created to meet this need. It provides the developer the means to create an 
industrial strength Server. Complete make-files are included for all FairCom 
commercial platforms. With our proven kernel add or override existing database 
functionality or create your own special multi-threaded server: 

Application Server Network Gateway Server Data Warehouse 

Special Web Server Departmental Database Server Embedded Servers 


FairCom Server Development System key features: 

Provides complete source code for all the interface subsystems to the FairCom 
Server. Server mainline, Communication, Threading, Remote function interfaces and 
procedure calls are all supplied in complete C source code together with the 
FairCom Server sophisticated thread-safe kernel libraries. 


Customizable 
Transaction Processing 
Online Backup 
Disaster Recovery 


Rollback-Forward 
Anti-Deadlock Resolution 
Client Side Source 
Multi-threading 


Data History 
Multiple Protocols 
Heterogeneous Networking 
File Mirroring 


Conditional Index 
Small Memory Footprint 
OEM pricing 
ODBC/Java interface 
Key level locking 




conponation 

Commercial Database Technology. Since 1979 . 

USA. 800.234.8180 

Phone: USA 573.445.6833 ■ EUROPE +39.35.773.464 - JAPAN +81.0592.29.7504 - BRAZIL +55,14.224.1810 
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Finally, someone 
got the message. 


You’re not alone anymore! Stingray’s MFC Classes are here to help! 


O You know the great features you want in your applications, but 
are stranded due to limitations in MFC. Stingray Software can 
save you with a family of MFC extensions that add sophisticated 
f TU I fun c ti ona lity in just minutes ^^^S-.— 

Flave you ever tried to add docking windows, like Microsoft 
Developer Studio? What about shortcut bars like Microsoft Outlook ? 
Or multi-selection tree controls? Do you want '97 “cool style’’ 
toolbars with drag and drop customization without spending 
months coding? Objective Toolkit™ provides these and over 70 
extensions that add the coolest GUI functionality — in just a fraction 
of the time it would take you to build them from scratch. New 


you can feel lost at sea. With a family of over 


a dozen products, 

Stingray Software is fast 
becoming the one-stop 
shop for the object -oriented 
developer. 

To find out how Stingray Software 
can rescue you, surf to our web 
site for free demos, evaluation 
copies and white papers. 


Objective Toolkit PRO™ goes beyond Objective Toolkit to 
solve some of the more complex problems in the MFC architecture. 


All Stingray libraries come with FULL SOURCE CODE at NO 
ADDITIONAL CHARGE and have a 30 day money back guarantee. 


If you need grids and charts to present different views of your 
data — but the schedule is just too tight, then Objective Grid™ 
and Objective Chart™ are for you. You save hundreds of hours 
by using the built-in wizards and now Objective Grid has complete 
Excel formula support. 

Do you want to provide graphical layouts in your applications? 
Don't spend months struggling with the GDI, use Objective 
Diagram™. It comes complete with zoom and print support plus 
OLE automation to transfer your layouts to other programs. 

When you need to provide a full-featured color syntax editor, 
don’ t spend mo nths writing c ode — turn to Obj ective Edit™ . 


Stingray Software, Inc. • 800-924-4223 • 

www. st i n 


919-461-0672 



All products and brand names are trademarks and/or registered trademarks of their respective holders. 


The Next Generation of Development Tools 























































EDITORIAL 


Is It Real Time, 
or Is It 
Microsoft? 


M ore than once, Microsoft’s marketing knuckles have been rapped for its nasty little habit of 
preannouncing products. Not that rebukes seem to matter, if Microsoft’s recent 
preannouncement for adding “hard” real-time capabilities to Windows CE is any indication. 
According to a somewhat nebulous press release, Windows CE will be a “hard” real-time operating 
system with the release of Version 3.0 sometime in the second quarter of 1999. Interestingly, at last 
fall’s Embedded Systems West Conference, Microsoft was careful not to call Windows CE 2.0 “hard” 
real time at all. Then suddenly, like pigs sprouting wings, Microsoft was referring to WinCE as a hard 
RTOS at this spring’s Windows CE Developers Conference. (Soft real time is more forgiving than 
hard. Soft real time can miss deadlines in cases where not completing tasks is more acceptable than a 
failure. Hard real-time deadlines, on the other hand, must always be met. At minimum, hard real time 
must be deterministic, have low latency, and support nested INTs.) 

When asked about this in a DDJweb site “Online OP-ED” interview (http://www.ddj.com/), a 
WinCE product manager cleared things up, explaining that the 1999 release of WinCE 3.0 will be 
“true” hard real time, implying that WinCE 2.0 is some other kind of hard real time. Yes, by the 
most minimal of definitions, WinCE 2.0 is a RTOS— but it’s about as hard as butter on your 
morning biscuits. 

WinCE has a long way to go before it can truly be called hard real time—especially when 
compared to tried and tested RTOSs such as QNX, VRTX, VxWorks, pSOS, and the like. (For 
instance, some WinCE latency figures are measured at from 93-273 microseconds; under QNX, 
comparable figures are at about two microseconds.) In all likelihood, a total rewrite of the WinCE 
kernel will be required to bring WinCE up to par with real RTOSs. But for all we know, of 
course, that rewrite is underway. 

If history has taught us anything about Microsoft, it is that the company has a hard time 
meeting promises when it comes to shipping operating-system products—especially when those 
products are announced more than a year in advance. Having more resources than most of us 
can imagine didn’t necessarily get Windows 95/98/NT 5.0 out the door when promised, making 
you wonder why Windows CE should be any different. 

So why does Microsoft keep on preannouncing operating-system products so far in advance? 
More than likely to freeze the marketplace until a minimal implementation of what’s promised can 
be delivered. Clearly, that marketplace would be better served by walking the walk, instead of 
talking the talk. 

% ^ :jc 

About the same time Microsoft was exhibiting chutzpah in the real-time realm, O’Reilly & 
Associates was down the road patting itself on the back over its self-proclaimed “historic” Open 
Source Summit. According to its press releases, O’Reilly brought together “heavyweights of the 
Internet software community...to explore ways of expanding the use and acceptance of open 
source software development.” 

No question, this is an admirable goal that deserves all of our support. The invitation-only 
event included the likes of Linus Torvalds, Larry Wall, Brian Behlendorf, John Ousterhout, Guido 
van Rossum, Phil Zimmermann, John Gilmore, Eric Raymond, Tom Paquin, Jamie Zawinski, 

Sameer Parekh, Eric Allman, Greg Olson, and Paul Vixie—each of whom deserves accolades for 
his contribution to the world of software development. 

More noticeable, however, was who wasn’t invited. If any single person deserves credit for 
launching the open source software movement, it’s Richard Stallman of GNU and free software 
fame. An “open source summit” without Stallman is like a cheeseburger without the cheddar. 

When, in response to a flurry of O’Reilly e-mail press releases, I asked by reply why Stallman 
wasn’t invited, the net went suddenly quiet. Inquiring minds want to know. 

*** 

A recent study by Software Success (http://www.softwaresuccess.com/) revealed a couple of 
interesting twists. The analysis, compiled by Software Success using data supplied by Dun & 
Bradstreet, showed that the total number of companies competing in the software industry grew 
from 58,779 in July 1997 to 68,765 in March 1998. For the first time since 1993 (when Software 
Success started tracking this data), the rate of growth of mid-sized companies was faster than that 
of startups. For instance, the number of companies with annual sales of under $500,000 (50,482) 
increased 12 percent since July 1997, the number with sales of $1 million-$5 million increased 42 
percent, and those with $10M and up increased 83 percent. Software Success also found that the 
number of companies in the software-related services sector grew 45 percent to 19,542, reflecting 
a migration of some formerly product-based companies to the services sector. 


Jonathan Erickson 
editor-in-chief 
j erickson @ ddj. com 



6 


Dr. Dobb’s Journal, July 1998 








Introducing 


Rogue Wave 

SOFTWARE 


Tools.h++ Professional 



for 0+ Professionals 


For years, Tools.h++ has provided C++ 
developers like you with rich, robust, and 
versatile foundation classes useful for 
building virtually any application.Today, 
your applications must perform in more 
complicated hardware and software 
environments than ever before. 

Now, Tools.h++ Professional gives you 
the expanded and integrated tool set you 
need to meet the challenges of even your 
most complex development project. 

Tools.h++ Professional includes Tools.h++, 
with over 130 foundation classes, plus 
Java/C++ interoperability, networking, and 
CORBA tools. Finally, a collection of 
powerful C++ tools that help you quickly 
build solid, portable applications for today’s 
complex computing conditions. 

Tools.h++ Professional.Tested and proven 
code, built by C++ language experts. Easy 
portability to most popular platforms. 
Network computing and language interop¬ 
erability solutions, plus fundamental C++ 
building blocks. A wealth of functionality in 
one convenient and affordable toolbox. 

What are you waiting for? 


Tools.h++ Professional gives you: 

Tools.h++ 

Java/C++ Interoperability Tools 

• Fundamental C++ building blocks 

• Java™ virtual streams 

• Easy-to-use interface to Standard C++ Library 

• C++ implementation of the Java serialization 

Networking Tools 

format 

• Network communication classes 

CORBA Tools 

• Thread-hot Internet classes 

• CORBA streaming classes 


Tools.h++ Professional contains technology formerly sold separately as Serialize.h++, JTools, Neth++, lnterNeth++, and ORBstreams.h++. 


www.roquewave.com/ad/best 

Call us toll free in the U.S. at (800) 487-3217. 

Telephone us in Europe: Rogue Wave Software GmbH:+49-6103-59 34-0 ♦ Rogue Wave Software B.V.: +31-20-416 06 57 
Rogue Wave Software S.A.R.L.: +33-1-5568 1008 ♦ Rogue Wave Software-UK. Ltd.: +44-118-988-0224 


Rogue Wave and .h++ are registered trademarks of Rogue Wave Software, Inc. Java is a trademark of Sun Microsystems, Inc. All other trademarks are the property of Rogue Wave Software. Inc. or their respective holders. 






Toyota Vehicle Selection System 


Software superior by design 


Computer Associates international. Inc., isfandia, NY 11788-7000, Alt other product names referenced herein are trademarks of their respective companies. 






Everyone agrees: the future belongs to objects. 

But today’s application developers have limited choices when it comes to harnessing the power of 
object technology without sacrificing performance, flexibility, or the freedom to use what you like. 

Jasmine™ gives you the power you need with the freedom you want. 

It’s the first complete and pure object solution that has it all: 

• The industry’s easiest integrated development environment lets you drag and drop, and use all 
your favorite tools: native Java support, ActiveX controls, built-in VB integration, and C++. 

• Jasmine is a powerful, true object database. It supports abstract classes, encapsulation, classifi¬ 
cation, inheritance (both single and multiple), unique object identity, methods (including instance- 
level, class-level, and collection-level), polymorphism, and aggregation. 

• An industrial-strength architecture featuring SMP SU(¥ «* UcS INDICATIONS *T 0 ECOUVRLZ NOS SfRVICfS jgjf 

support, backup and restore, security, and transaction -X 

management. 

• Built-in multimedia and Internet support: not only can 
you build and package the next generation of multi- 
media business applications; you can run them 
everywhere: Internet, intranet, extranet, client/server 
—all without recompiling. 

Jasmine is real. A proven, complete object-oriented 
database and development environment. Unlike hybrid or 
partial object solutions, Jasmine actually works. 

So you can shorten your time to market and gain a distinct competitive advantage 

Try it out—pick up the phone right now. Because Jasmine is ready today. 

Are you? 
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Call 1-888-7JASMINE for your FREE Developer Edition CD 

orvisRwwiLcai.com 


LETTERS 



Dear DDJ, 

In the article “Date Compression and Year 
2000 Challenges,” by Robert L. Moore and 
D. Gregory Foley (DDJ, May 1998), I was 
surprised to see the Windowing concept 
referred to as a preferred method for meet¬ 
ing the much closer Year 2000 deadlines. 
Surprising, only in that I’ve previously sug¬ 
gested the same method, and your discus¬ 
sion of the approach shows I’m not total¬ 
ly out of touch with reality. 

In Robert and Gregory’s discussion, one 
aspect of Windowing may benefit from an 
alternate approach. 

In dealing with sorting of Y2K-deficient 
data, they mentioned an interpretive pro¬ 
gram would need to be activated for con¬ 
verting non-Y2K data into a sortable Y2K- 
compliant format. A secondary interpretive 
program would then need to be written for 
converting the sorted Y2K-compliant output 
back into its native format. Instead of this 
approach, if achievable, the following 
would be preferred. 

Have the OS sort utility modified to in¬ 
clude a sort option that incorporates a Win¬ 
dowing interpretation. In the JCL, a one- 
byte field would indicate that sort requires 
the sort Windowing option. This field (code) 
would be available for each sort field. As 
with Windowing, the sort parameters would 
contain a singular field for specifying the 
Windowing (pivot) year. The sort would 
perform an on-the-fly Y2K interpretation 
while sorting the data, without actually mod¬ 
ifying or expanding file contents. 

I realize many OSes may be in use and 
are no longer upgradable. With the billions 
of dollars which will need to be spent on 
Y2K compliance, I would think enough 
clout could be established to coerce some¬ 
one to make the required modifications. 

An alternative, the interpretative pro¬ 
grams (used before and after each sort) 
described in the article could be designed 
to utilize the JCL passed codes, similar to 
the sort parameters context in order to de¬ 
termine which fields need to be convert¬ 
ed. By using variable parameters of this 
nature, it wouldn’t be necessary to write 
a separate set of programs for each sort. 


Storing the pivot year in the Working 
Storage Section was also recommended. If 
only one program needed modification for 
Y2K compliance, that would be great. How¬ 
ever, thousands of programs are going to 
be modified. To adhere to a Sliding Win¬ 
dowing concept, storing the pivot year in 
Working Storage would require massive 
modifications just to affect a new Window. 
Perhaps a singular file containing the def¬ 
inition of the Windowing method/period 
could be created (for storage of any peri¬ 
odic variable data). Then each affected pro¬ 
gram would open the file, extract the win¬ 
dowing data, then store the data in Working 
Storage. 

After this was integrated into all pro¬ 
grams utilizing the Sliding Windowing con¬ 
cept, modifying the pivotal year file would 
simultaneously affect all programs. 

Wayne H. Wilhelm 
whw96sv@cardnet.stark.kl2.oh.us 

Dear DDJ, 

One problem with all the compression 
schemes mentioned by Robert L. Moore 
and D. Gregory Foley in their article “Date 
Compression and Year 2000 Challenges” 
(DDJ, May 1998) is that human readability 
is lost. ASCII only makes use of the seven 
least significant bits of each word. Using 
the most significant bit from each of the 
six characters used to represent a date by 
the MMDDYY method, and using a base 
year of 1900, we can extend the present 
method to 64 centuries. Hopefully in that 
time we can work out a better system. 
Dates printed by a routine that strips off 
the most significant bit will still be human 
readable. 

Lloyd C. Brown 

Lloyd.Brown@gat.com 

Dear DDJ, 

I congratulate Robert L. Moore and D. Gre¬ 
gory Foley on their clear, well-written ar¬ 
ticle “Date Compression and Year 2000 
Challenges” (DDJ, May 1998) that focus¬ 
es on the fundamental engineering prob¬ 
lem of the Y2K “situation.” At work, I have 
had to complete many spurious Y2K forms 
and questionnaires from customers who 
just don’t get it, and who have latched on 
to the four-digit year as a mantra to pro¬ 
tect themselves from Y2K ruin. With 
Robert and Gregory’s article, perhaps I can 
teach them to converse rationally about 
the subject (one can always hope). 

However, I was disappointed about a 
slight omission in the discussion—the is¬ 
sue of backward compatibility of storage. 
As mentioned in the article, there are two 
goals in programming a Y2K fix: to pro¬ 
vide a representation for all dates the sys¬ 
tem could possibly need, and to do this 
with a minimum of programming effort 


(including software maintenance). The au¬ 
thors also mention that compression meth¬ 
ods can reduce the amount of coding re¬ 
quired to fix Y2K problems. You can 
reduce that effort even further if you don’t 
have to convert all your persistent data to 
a new representation. 

All of the compression methods provid¬ 
ed in the article use the entire “value space” 
of each representation. As such, they all 
collide with the legacy representation. For 
example, the six characters “012001” could 
mean January 20, 1901 (MMDDYY) or Jan¬ 
uary 1, 1912 (CYYDDD) or January 20, 
12337 (MMDD l6b-year). So there is no 
way to examine a date to determine the 
encoding scheme used. Implementing these 
representations requires that all existing 
data be converted before the new software 
may be used, and that the old software is 
fully retired before the change. 

Namespace techniques can be used to 
remove this burden, by designing the new 
representation to be complementary with 
the legacy representation. As mentioned in 
the article, the MMDDYY format makes 
very sparse use of the 48 bits required for 
storage; all of the methods described by 
the authors can be modified to exclude the 
normal MMDDYY representations from 
their “value space” and still retain suffi¬ 
ciently large ranges of dates. For instance, 
modify the CYYDDD format so that val¬ 
ues of C start at “2”; values of “0” and “1” 
would indicate data in the old format. This 
still provides 900 years of dates, but allows 
the program to read data in both CYYD¬ 
DD and MMDDYY formats. Similar tricks 
will work with each of the other formats 
described—I leave the details as an exer¬ 
cise to the reader. 

By using a backward-compatible com¬ 
pression scheme, the need for updating ex¬ 
isting data sources to the new representa¬ 
tion is removed. To implement the fix, we 
only need to reprogram the data interface 
(read from/write to storage), possibly ad¬ 
justing the internal date format and user out¬ 
put to account for the increased range of 
dates. Then release the revised program to 
users. In my experience, this is the minimum 
effort required to correct a Y2K deficiency. 

Curtis S. Carney 

awiggin@slip.net 

Java and CORBA 

Dear DDJ, 

In “Building Distributed Applications with 
Java and CORBA” (DDJ April 1998), Bryan 
Morgan does a good job with outlining to 
intricacies of CORBA. I do find, however, 
that I cannot agree with some of his state¬ 
ments and findings. 

First, CORBA is not a vendor-independent 
operating system. The Object Management 
Group (OMG) never intended CORBA to re- 
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(continued from page 10) 
place the core operating system of any node 
in an ft-tier client/server environment. 
Bryan’s statement can leave someone think¬ 
ing that CORBA can replace NT or UNIX. 
Had Bryan stated that CORBA provides a 
vendor-independent environment for inter¬ 
object management across a network, I 
would have agreed with him. 

Secondly, the proper use of the Inter¬ 
net Inter-ORB Protocol (HOP) is somewhat 
of a religious war among CORBA propo¬ 
nents. Bryan flippantly discusses HOP as 
a “wire-level protocol that resides on top 
of TCP/IP.” He further states that HOP “lets 
one vendor’s CORBA 2.0-compliant ORB 
exchange objects with another’s.” Bryan is 
certainly stating the promise of HOP rather 
than the fact. Let’s look at the facts: 

• Since CORBA is a suite of guidelines and 
does not dictate how a vendor should im¬ 
plement its CORBA-compliant solutions, 
inter-operability among the various ORBs 
is less than ideal—even with HOP. 

• HOP is a good beginning toward ad¬ 
dressing ORB inter-operability, but falls 
short of synchronizing such CORBA ser¬ 
vices as security and time across ORBs. 
Companies building CORBA-based ap¬ 
plications are advised to choose a sin¬ 
gle ORB vendor and remain as homo¬ 


geneous as possible. Mixing and match¬ 
ing ORBs is risky business in today’s 
client/server world. 

• One of the original intentions of HOP 
was to build a bridge between CORBA 
and the Distributed Computing Environ¬ 
ment (DCE). CORBA proponents recog¬ 
nize that while DCE is falling from favor 
in the ft-tier client/server environment, it 
provides mature network services for 
building and managing client/server ap¬ 
plications. DCE, unlike CORBA, is an in¬ 
dustry standard rather than a suite of 
guidelines. As an industry standard, DCE 
limits the implementation variation across 
vendors. Moreover, some of the most ro¬ 
bust security and authorization facilities 
have grown out of the DCE standard, like 
Kerberos. 

• Many CORBA-compliant vendors cur¬ 
rently have stable products for CORBA 
1.0—fewer have stable products for 
CORBA 2.0. Since IIOP is part of the 
CORBA 2.0 specification, it would not 
make sound business sense to use IIOP 
to integrate ORBs from two or more 
vendors without knowing how each ven¬ 
dor has implemented their respective 
CORBA services (this defeats the pur¬ 
pose of encapsulation at the ORB ser¬ 
vice level, a foundation of object man¬ 
agement). 


CORBA is certainly the wave of the fu¬ 
ture. Since CORBA is an evolving specifi¬ 
cation, it is important that forethought and 
prudence are used to ensure that we build 
feature-rich and robust object-based 
client/server applications. As Java replaces 
C++ as the developer’s tool of choice for 
building client/server applications, we must 
create greater awareness of what is real 
and doable, versus what is promised. 
Richard S. Kravchuk 
richard.kravchuk@ey.com 

Window Sizes and the Registry 

Dear DDf 

Thanks to Al Stevens for the info in his April 
1998 “C Programming” column on how to 
solve the problem with a window that could 
either be maximized or minimized. I had a 
clean install of Microsoft office on my ma¬ 
chine. The only problem was that Microsoft 
Photo Editor refused to be anything but 
maximized or minimized. After reading Al’s 
column, I searched the registry and found 
InitialPosition= 65500,2,66112,565.1 deleted 
that and all is well now. Not a big deal, 
kind of annoying, so I never went too far 
in finding out the problem. 

Kevin Peck 
KPeck@ bridge. com 

DDJ 
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TRANSFORMS 

Including resize, resample (interpo¬ 
lated resize), rotate (.01 degree), flip, 
invert, reverse, crop, underlay, shear, 
transpose, fill, auto deskew and com¬ 
bine bitmap (with mathematical and 
Boolean operations). 


FILTERS 

Including sharpen, blur, brighten, 
darken, invert, hue and saturation, 
intensity, contrast, gamma 
correction, histogram equalize, edge 
detect, line detect, emboss, mosaic, 
posterize, median and noise filters, 
spatial filter (which can be pre¬ 
defined such as gradient, laplacian, 
sobel, prewitt, shift and difference, 
line segment, or they can be 
customized), and more. 


DRAWING 

Draw directly to a bitmap surface 
using any of the windows GDI 
functions (such as TextOut, BitBIt, 
Ellipse, and Rectangle). 


REGION OF INTEREST 

Process only a specific portion of an 
image rather than the entire bitmap. 
Regions can be comprised of any 
combination of rectangles, ellipses, 
rounded-rectangles, freehand 
shapes, polygons, transparent color 
and more. 
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LEADTOOLS provides optimized rendering 
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monitor calibrations, auto-dithering, 
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are unlimited. Other Special Effects 
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INTERNET/INTRANET 

LEADTOOLS features a Net Aware ActiveX 
and a Netscape plug-in for 
Internet/Intranet applications, including a 
Bitmap Datapath allowing images to be 
read from any URL, Progressive JPEG, 
Progressive CMR and support for GIF 
interlace, transparency, animation, and 
embedded text. A FeedLoad function has 
been created to allow image data to be 
displayed as it is being transmitted across 
the net. 

DATABASE 

LEADTOOLS has specific features designed 
for the imaging database developer: VB 
data binding, 32-bit ODBC, a customized 
OLE 2.0 in-place server, Load/Save 
memory, and Load/Save file offset. 

LEADTOOLS is backed up by a 30-day money back 
guarntee (US & Canada only) and FREE technical support is 
available via phone, fax, Internet, CompuServe or BBS. 


SCANNING 
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16 & 32 bit native and buffered RAM 
transfer modes. 

PRINTING 

LEADTOOLS performs all image processing 
necessary to print directly to any Windows 
supported printer, with the ability to print 
text and multiple images on the same 
page. 

COMPRESSION 

LEADTOOLS offers more compression 
options than any other toolkit on the 
market, in both standard and proprietary 
formats. 
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LEADTOOLS is a collection of more than 
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“LEADTOOLS is an indispensable 
tool, we used it in the development of 
our FrontPage application". 

Tom Button 
Director of Marketing, 
Internet Platform & Tools division 
Microsoft 


"The file format support is phenome¬ 
nal, LEADTOOLS gave Micrografx's 
applications (like CreataCard™ and 
Picture Publisher™) the flexibility to 
import and export a wide variety of 
established and new file formats with 
ease. Their format implementations 
are complete and performance Great!" 

Andy Cohen 
Director Software Development 
Consumer Products 
Micrografx 
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ActiveReports 

by Data Dynamics 
For VB developers who need 
to generate a wide variety of 
reports from their applications, 
ActiveReports is an ActiveX 
Designer that is powerful and 
easy to learn. Unlike any other 
report writer, our product takes 
full advantage of VB's powerful, 
familiar language 




$ 329 .*• 

Paradise No. M47 0112-FT 


Visual Studio 97 Pro 

by Microsoft Corp. 

* Price after $100 manufacturer's rebate. 


Active 

ToolBars 



$145 


Paradise No. S16 0810-FT 

ActiveToolBars 

by Sheridan Software Systems 


Programmer's Paradise 

the developer s definitive source for software! 


WISE Installation 
System Enterprise 
Edition 

by WISE Solutions 
The WISE Installation System 
Enterprise Edition incorporates the 
award-winning WISE Installation 
System, and the tools required for 
any type of application deployment. 

The Enterprise Edition includes SmartPatch, 
WebDeploy, and SetupCapture. The WISE 
Installation System creates professional 
installation programs for Windows, 
Windows 95, and Windows NT. WISE 
is a completely Windows-based installation 
editing/testing environment. 
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PluginWizard” 

by Asgard 
Harness the power 
of ActiveX controls in 
Netscape Navigator. 

Asgard PluginWizard will 
quickly generate Netscape 
Plugins from your own 
or 3rd party ActiveX 
controls. The standard 
edition directly creates 
a non-scripting plugin 
executable, while the professional 
edition generates full LiveConnect 
plugin source code. Royalty free! 
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Visual SlickEdit 

by MicroEdge 

This award-winning editor increases 
development productivity, reduces 
costs of software maintenance and 
improves software quality through 
powerful features, software 
standardization and compatibility 
with your existing environment. 

Software Standardization 
With its multi-platform presence, integration 
with industry leading development environ¬ 
ments and compatibility with version 
control systems, Visual SlickEdit provides 
your entire organization with a standard 
coding environment. 
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ProEssentials™ 

by GigaSoft ® 

16-and 32-bit DLL, OCX, VCL, 
and VBX interfaces providing 
charting functionality with 
consistent visual quality, 
real-world practicality, and 
overall professional appeal. 

Suited for engineering, 
financial, data-acquisition, and information system development. 
Be sure to find the best tool for your important development 
needs. Download a demo [500K] or get a 
fully functional evaluation edition [3Meg] at 
www.pparadise.com/publishers/gigasoft Paradise No. 
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ClassMagic 

by Object Dynamics 
Assemble Windows applications, 
COM components or DLL in C++, 
using your current tools, libraries 
and code! Cut in half the code 
you write—create modular, 
thread-safe classes, connect 
objects, assemble new 
classes from interconnected 
objects, package them 
together. Includes the 
ClassMagic engine, library 
of reusable software parts, 
source samples, complete 
documentation and much more. 
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VBTools 6 

by BeCubed Software 
Update your 16-bit applications 
today with any of the more than 60 
custom 16-bit VBX controls! You'll 
save bunches of time with the new 
International control because it 
assigns internationalized text to 
all loaded controls! And there's 
a Flow Charting control, 
a 2D Slider, a Floating 
Text Extender and 
more, plus many 
other enhancements! 



Multi-Edit 8 

by American Cybernetics 
Multi-Edit 8 is the only 32-bit 
source-code editor a programmer 
needs. Fully customizable, it ships 
with extensive multi-language 
support including Web languages, 

IDE and VCS Integration and 
syntax highlighting. Run compilers 
and other tools in the background. 

Cut keystrokes in half with lan¬ 
guage-specific Smart Indenting, Template Editing, 
and Construct Matching. 
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Spread v2.5 
by FarPoint Technologies 
A complete spreadsheet control 
for most environments that 
support a VBX, OLE control, or 
DLL. Use as a spreadsheet to 
obtain variable lines of data or 
display tables of information. 
Data-aware—connect to 
databases with the Access Engine 
and ODBC. Includes over 250 
properties and our improved 
Spread Designer. Formulas, sorting, 
and full-print support too. 
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The Fastest & Easiest Way to Create Help Systems 

by Blue Sky® Software 

RoboHELP 6.0 

The Best Selling Help Authoring Tool* 

RoboHELP is the fastest and easiest way to create online Help for any 
platform. RoboHELP turns Microsoft Word into a full-featured authoring 
tool capable of creating professional Windows Help, WebHelp, 

Windows 98 Help (Microsoft HTML Help), Netscape NetHelp, printed 
documentation, intranet/Internet Web sites, and Windows CE Help— 
all from a single source. * Based on independent market survey. 

RoboHELP Office 6.0 
The Complete Help Authoring Solution 
RoboHELP Office provides a complete Help authoring solution with a 
suite of powerful tools for authoring nine professional Help formats, 
including the new Windows 98 Help format. Includes the award-winning 
RoboHELP, RoboHTML (at no extra cost-$499 value), plus over 16 
powerful Help authoring utilities. 
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LEADTOOLS 
ActiveX Pro 32 
by LEAD Technologies, Inc. 
LEADT00LS offers technology in all 
major imaging categories for color, 
grayscale and bitonal imaging, with 
comprehensive functionality in each 
category. LEADT00LS is an integrated 
development toolkit with more than 
500 functions, properties and methods. 
Common Dialog boxes make LEADT00LS 
easier to use and add-on modules are 
available for additional FlashPix, OCR, and 
Video support. 
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Doc-To-Help 
by Wextech Systems 
Create HTML Help, Windows 
Help for 95, NT 3.51/4.0 and 
3.0/3.1, HTML, and printed 
documentation from one file, 
at the touch of a button, with 
Doc-To-Help 3. Wextech, the 
Microsoft acknowledged expert 
in HTML Help authoring, 
incorporates our experience 
in Doc-To-Help 3, enabling you 
to create great HTML Help. 
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Codewright Pro 

by Premia 

You'll work faster and easier 
when you use the right 
programmer's editor, 

Codewright. Now you'll 
browse code faster with 
Outline Symbols. It gathers 
information about your code 

in the background. You'll juggle changes with ease, with 
Difference Editing. It lets you selectively combine the changes 
from two revisions. The new Bookmarks Window lets you view 
bookmarks by name and by file. Now with 
synchronizing technology for Delphi and 
Visual C++ IDEs. With the help of the API 
Assistant, making complex function calls is 
as simple as filling in a form. 
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RoboHTML 
by Blue Sky® Software 
Easily Create 
Windows 98 Help 

RoboHTML is the only product 
specifically designed to create the 
new Windows 98 HTML Help standard. 

RoboHTML provides a rich WYSIWYG 
editor with full drag and drop support, 
automated project management, and 
complete testing features. Unlike HTML 
editors, RoboHTML has built-in support for all Windows 98 
specific features such as: dynamic Table of 
Contents; multi-level Indexes; and Related Paradise No. 
Topics. Also supports easy creation of Popups, 813 G320-FT 
Navigation Buttons, Splash Screens, Shortcuts, ^ 

Import existing WinHelp projects and more. Sl4D«J 



KEDIT for 
Windows 1.5 
by Mansfield 
Software Croup 
Includes both 32-bit 
Windows 95/Windows NT 
and 16-bit Windows 3.1 
modules. KEDIT is a powerful 
general purpose text editor with 
redefineable keys, undo/redo, selective line editing, regular 
expression support, enhanced syntax coloring, column oriented 
editing, file locking, a macro debugger, an IBM XEDIT-compatible 
command set, prefix area support, and more! 

The macro language is a subset of REXX. 

Also available in DOS and OS/2 text 
mode versions. 
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TestTrack 

by Seapine 
Software 
TestTrack is 
the fastest and 
most complete 
multi-user bug tracking solution for Windows 95/NT. 
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And the Winner Is... 

The West Coast trounced the East Coast 
for the seventh time in ten tries at The 
Computer Museum’s Tenth Annual Com¬ 
puter Bowl, a trivia contest held in Boston 
(West Coast fans gathered in Silicon Val¬ 
ley at Moffett Field’s Hangar One to par¬ 
ticipate via video simulcast) that pits teams 
of five industry luminaries against each 
other. The West Coast, garbed in cowboy 
hats and led by Netscape cofounder Marc 
Andreesen, dominated the event, beating 
the frilly-shirt-wearing East Coast, 230-70. 
John Ratzenberger (aka Cliff Clavin, mail¬ 
man and trivia buff from the TV show 
Cheers ) was master of ceremonies of the 
event, asking questions ranging from the 
highly technical (“How many times more 
bandwidth does a T1 line have than a 
56 kilobaud modem?”) to the highly ob¬ 
scure C‘How many microprocessors are 
there on Mars?”). Pride and fine food were 
at stake, which raises money for the mu¬ 
seum-— Sunnyvale, California, Mayor 
James Roberts won a lobster feast from a 
bet with Boston, Massachusetts, Mayor 
Thomas Menino. For more information, 
see http://www.computerbowl.org/. 

Biometric Security 
Moves Forward 

SAC Technologies (http://www.sacman 
.com/),, a biometrics security company that 
provides technology for network and com¬ 
puter security without the use of pin num¬ 
bers, passwords, or tokens, has received 
certification from the InternationarCom- 
puter Security Association (http://www.icsa. 
net/). Certification was in the one-to-many 
Identification category. Identification is the 
process of comparing the biometric char¬ 
acteristics of an unknown individual 
against characteristics stored in a database 
to determine their identity. Identification 
asks, “Who is this?” and establishes 
whether more than one biometric record 
exists, thus denying an individual who is 
attempting to pass himself off with more 
than one identity. 

Don’t Blink 

A “PIN-less” automatic teller machine 
(ATM) has gone online at the Nationwide 
Building Society bank in Great Britain. 
The system, designed by NCR, uses a bio¬ 
metric iris-identification system developed 
by Sensar (http://www.sensar.com/). To 
use the system, bank customers simply in¬ 
sert their ATM card into a reader and a 


camera mounted in the machine compares 
the customer’s iris (one of the few human 
body parts to remain unchanged as aging 
occurs) with records in the databank. The 
process takes as little two seconds. 

Sensar uses iris-recognition software de¬ 
veloped by IriScan (http://www.iriscan. 
com/). The software is also being tested in 
Virginia by Spring Technologies as an au¬ 
tomated fare-collection system in mass- 
transit applications. The goal of this auto¬ 
mated system, called “TranScan,” is to 
expedite commuter entry and exit at sub¬ 
way and train stations by minimizing and 
eventually eliminating the commuter’s 
need to insert a card, pass, or token. 

Macro Writing Contest 

Premia Corp. has announced a macro 
writing contest for Premia’s Codewright 
Programmer’s Editor. The contest is be¬ 
ing run in conjunction with the addition 
of Perl, AppBasic, and API (C-like) 
macros in Codewright 5.1. The grand 
prize for the best macro is $5000, or one 
of a number of other prizes. In addition, 
there will be first, second, and third place 
prizes for macros written in each of the 
three macro languages. Submissions must 
be received no later than August 1, 1998. 
Winners will be announced at the SD ’98 
East Conference in Washington, D.C. on 
August 18, 1998- For more information, 
see http://www.premia.com/. 

E-Stamps on the Way 

The U.S. Past Office has approved electronic 
postage stamps (e-stamps) for testing and, 
if things go as expected, we’ll be printing 
our own stamps using PCs and the Internet. 
E-stamps include the postage amount, name 
and zip code of the local post office, date 
the postage was printed, and rate category 
(first class or whatever). In addition, e-stamps 
will have electronic bar coding of the same 
information as well as the identification num¬ 
ber of the printing device and a digital pat¬ 
tern that will make each envelope unique 
and hard to counterfeit. 

The system approved for testing, called 
“SmartStamp,” was developed by E-Stamp 
Corp. (http://www.e-stamp.com/). Other 
approaches, such as PostagePlus from 
Neopost (http://www.neopost.eom/9, are 
coming online too. SmartStamp requires 
dongle-like hardware that fits into a print¬ 
er port, serving as an electronic vault for 
postage. PostagePlus, on the other hand, 
requires no additional hardware. Cus¬ 


tomers will have an account with e- stamp 
companies and can download postage into 
this vault via the Internet. 

Deja Cygnus 

Over the last few years, Metrowerks’ Code- 
Warrior (http://www.metrowerks.com/) de¬ 
velopment tools have been extended from 
their Mac origins to include support for a 
wide array of languages (C, C++, Object 
Pascal, and Java), processors (including x86, 
PowerPC, MIPS, and Java VM), and systems 
(BeOS, PowerStation, Windows, and so on). 

One of Code Warrior’s biggest competi- 
tprs is GNU GCC, which has good sup¬ 
port for cross-compilation to a variety of 
processors. To better appeal to compa¬ 
nies that have standardized on GNU GCC, 
Metrowerks now officially supports the 
GNU GCC compiler from within the Code- 
Warrior environment (as an alternative to 
Metrowerks’ own compiler). A new sub¬ 
sidiary, Quorum Technologies, has been 
formed for the express purpose of sup¬ 
porting GCC within CodeWarrior. 

Cryptographers 
Crack Cell-Phone Code 

Taking only about six hours of work, cryp¬ 
tographers at the University of California 
at Berkeley cracked Global System for Mo¬ 
bile Communications (GSM) codes, en¬ 
abling them to “clone” a digital cellphone 
and make unauthorized calls from anoth¬ 
er phone. In the process, Ian Goldberg, 
David Wagner, and Marc Briceno also dis¬ 
covered indications that the code may 
have been intentionally weakened during 
its design. The GSM digital standard is the 
most widely used in the world, with more 
than 79 million phones in use. 

Worldwide PC Sales Climb 

According to a recent report by market- 
research firm Dataquest, sales of person¬ 
al computers continue to grow at double- 
digit rates/ Overall, says Dataquest, 
worldwide PC shipments were up 14.1 
percent for the first quarter of 1998, com¬ 
pared with the same period in 1997. U.S. 
growth was 16.2 percent. 

As for who’s leading the vendor pack, 
Compaq maintained its market-share lead 
with 12.5 percent worldwide and 17.1 per¬ 
cent in the U.S. Dell Computer Weighed 
in with an 11.7 percent in the U.S. World¬ 
wide shipments by Hewlett-Packard and 
Dell were up 72 percent and 66.1 percent, 
respectively, over the last year. 


16 


Dr. Dobb’s Journal, July 1998 












Beam 


JClass Java Beans - commercial quality, 100% Java components for JDK 1.0.2 or 1.1 
let you unleash the power of your Java IDE. 




0 Java Workshop 
P] JBuilder 
PI PowerJ 
PI SuperCede 
PH VisualAge for Java 
PI Visual Cafe 
p] Visual J++ 

and many more.. 


JClass LiveTable 

The most flexible and powerful 
grid/table control 
available 


JClass Chart 

Feature-rich charting from 
the experts! 


JClass BWT 

21 "must-have" Beans, 
including advanced tabs, 
outliner/tree and A 

multi-column list ^ 


and validation, 
including l 
calendar 




ActiveX 


Discover why thousands of 
Motif developers find XRT 
widgets indispensable - call 
for your free 30-day evaluation. 


PageFormatter - 
the easiest way to 
add PostScript 
printing to UNIX 
applications. 


Olectra Chart 

Speed, flexibility and control - charting 
power with no compromises. Includes 
16- and 32-bit OCXs and DLLs. 


Olectra Resizer 

Easy, intelligent resizing behavior 
for Visual Basic forms. 




hmmmmmm. 


K IL„ G Wt O ¥» 

Setting the standard for professional 
software development tools 


KL Group Europe B.V. Tel: +31 (0)20 679 95 03 Fax: +31 (0)20 470 03 26 
www.klg.com 

* Pikes ii U.S. dote. Pikes figha outside North Amedeo. JClass, JCIuss BWI, JOoss Chort, JOoss Field, JOoss IMable, Olectio, Otectro Chart, Otectio Resize*. Pogef ormatla, XRT, XRT/3d, 
XRT/field, XRT/geor, XRT/grcvh ond XRI/tobte oe liodemotks of Id Group Ire. Al other products ore tmdemodcs or registered trademoks of their respective composes. QQQO1 


Jorge Chang, Algorithmics Incorporated - makers of RiskWatclr 


[Class works with: 


Call 1-800-663-4723 

Evaluate/Order mm.klg.com 





























Composing Reactive 
Animations 


Programming for greater 
freedom of expression 

Conal Elliott 

here’s no question that computer graphics — especially 
interactive graphics—is an incredibly expressive medium 
with potential beyond imagination. However, few people 
are able to create interactive graphics, so what might be 
a widely shared medium of communication is instead a tool 
for specialists. The problem is that authors still have to wor¬ 
ry about how to get a computer to present content, rather than 
focus on the nature of the content itself. For instance, behav¬ 
iors such as motion and growth are generally gradual, con¬ 
tinuous phenomena; moreover, many such behaviors go on 
simultaneously. Computers cannot directly accommodate ei¬ 
ther of these basic properties, because they do their work in 
discrete steps rather than continuously, and they only do one 
thing at a time. Graphics programmers consequently have to 
bridge the gap between what an animation is and how to pre¬ 
sent it on a computer. 

If the kind of programming in use today (like that described 
in the accompanying text box “Models versus Presentations” on 
page 25) is unsuitable for most potential authors, then we need 
to move toward a different form of programming. Alternative 
forms must give authors freedom of expression to say what an 
animation is, while invisibly handling details of discrete, sequen¬ 
tial presentation. In other words, these forms must be declarative 
(“what to be”), rather than imperative (“how to do”). 


Conal is a member of the Microsoft Research Graphics Group. 
He can be contacted at conal@microsoft.com. 


In this article, I present one such approach to declarative pro¬ 
gramming of interactive content. Fran (short for “functional re¬ 
active animation”) is a high-level vocabulary that lets you de¬ 
scribe the essential nature of an animated model, while omitting 
details of presentation. And because this vocabulary is embed¬ 
ded in a modern functional programming language (Haskell), the 
animation models are reusable and composable in powerful ways. 

Fran is freely available (with source code) as part of the Hugs 
implementation of Haskell for Windows 95/NT (http://www 
.haskell.org/hugs/). Newer versions of Fran may be found at 
http://www.research.microsoft.com/~conal/Fran/. The underly¬ 
ing ideas form the basis of Microsoft’s DirectAnimation, a COM- 
based programming interface accessible through conventional 
languages like Java, Visual Basic, JavaScript, VBScript, and C++. 
DirectAnimation is built into Internet Explorer 4.0, so you may 
already have it. 

There are three ways you can experience this article: 

• In this printed version, examples have an accompanying se¬ 
quence of snapshots. By scanning them from left to right, top 
to bottom (first row, second row, and so on), you’ll get a sense 
of motion. 

• On the Web (http://www.research.microsoft.com/~conal/Fran/ 
tutorial.htm), examples are illustrated by animated GIFs, show¬ 
ing animation over time, but not interactivity. That version of this 
article also contains additional discussion and several animations 
not in the printed version. 

• Finally, you can run the examples and interact with or mod¬ 
ify them. After installing Hugs (available at http://www 
.haskell.org/hugs/), double-click on the file tutorial.hs in 
the subdirectory lib\Fran\demos. At the > prompt, type 
“main” and press Enter. The examples will begin running. 
Press Spacebar, “n,” or right arrow to advance to the next 
animation, and “p” or left arrow for the previous one. If you 
want to display just a single animation ( leftRightCharlotte , 
for instance), then close the animation window and enter 
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“display leftRightCharlotte”. You can alter the definition in 
an editor, save the result, enter “:r” to the Hugs prompt, and 
“$$” again to display the new version. For 2D examples hav¬ 
ing a user argument u, use display!] instead of display. Sim¬ 
ilarly, for 3D examples, use displayG if there is no user ar¬ 
gument, and displayGU if there is a user argument. 

The First Example 

I’ll start with the animation in Figure 1 called leftRightCharlotte, 
which moves Charlotte from side to side. Listing One (listings 
begin on page 20) defines a value called leftRightCharlotte to 
be the result of applying moveXY to three arguments. (In most 
other programming languages, you would instead say some¬ 
thing like “moveXY(wiggle,0,charlotte)”.) 

The function moveXY takes x and y values and an image, and 
produces an image moved horizontally by x and vertically by 
y. All values may be animated. In this example, the x value is 
given by wiggle , a predefined smoothly animated number. Wig¬ 
gle starts out at 0, increases to 1, decreases back past 0 to -1, 
and then increases to 0 again—all in the course of two sec¬ 
onds, and then it repeats, forever. The second line defines char¬ 
lotte by importing a bitmap file, making it available for use on 
the first line as the second argument to moveXY. 

Although this example isn’t a masterpiece, it is nonetheless a 
complete animation program in just two short lines of code. 

Similarly, Figure 2 and Listing Two define an animation of Patrick 
moving up and down. To get the vertical movement, I’ve used a 
nonzero value for the second argument to moveXY. Rather than 
using wiggle , you use waggle , which is defined to be just like wig¬ 
gle, but delayed by half a second. 

Figure 3 and Listing Three combine the two previous exam¬ 
ples. The over operation glues two animations together, yield¬ 
ing a single animation, with the first one being over the second. 
Because I used waggle for upDownPat in this combined ani¬ 
mation, Pat is at the center when Charlotte is at her extremes 
(and vice versa). 


Composition 

Composition is the principle of putting together simple things 
to make complex ones, then putting these together to make 
even more complex things, and so on. This building-block 
principle is crucial for making even moderately complicated 
constructions; without it, the complexity quickly becomes un¬ 
manageable. 

Listings One through Three illustrate composition. I first built 
leftRightCharlotte out of charlotte, wiggle , and moveXY, then up¬ 
DownPat out of pat, moveXY, and waggle. Finally, I built char- 
lottePatDance out of leftRightCharlotte and upDownPat. A cru¬ 
cial point here is that when you make something out of building 
blocks, the result is a new building block in itself, and you can 
forget about how it was constructed. 

There is a more powerful version of composition, based on 
defining functions. Listing Four, for instance, defines hvDance 
(for “horizontally and vertical dance”), which combines any two 
images, in the way that charlottePatDance combines charlotte 
and pat. Now you can give a new definition for the dancing 
couple that gives exactly the same animation: charlottePatDance 
= hvDance charlotte pat. 

Having defined this generalized dance animation, you can 
go on to more exotic compositions. For example, you can 
take an animation produced by hvDance, shrink it, and put 
the result back into hvDance twice to make it dance with it¬ 
self. As Figure 4 and Listing Five show, the result is pleas¬ 
antly surprising. This example gives you a hint of how pow¬ 
erful it is to be able to define new animation functions. For 
instance, you could try charlottePatDance, stretched by a 
wiggly amount; see Listing Six(a). To prevent negative scal¬ 
ing, you take the absolute value of wiggle. Next, use hvDance 
again, but give it wiggly sized charlotte and pat. For visual 
balance, use wiggle and waggle ; see Listing Six(b). Next, put 
Pat in orbit around a growing and shrinking Charlotte. To get 
a circular motion, use moveXY, with wiggle for x and waggle 
for y; see Listing Six(c). 
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As you may have surmised, wiggle and waggle are related to 
sine and cosine and defined as: 

waggle = cos (pi * time) 
wiggle = sin (pi * time) 

The animated number time is a commonly used “seed” for 
animations and has the value t at time t. Thus, for instance, the 
value of wiggle at time t is equal to sin(nt). 

Rate-Based Animation 

Up to now, the positions of animations have been specified di¬ 
rectly. For instance, the definition of leftRightCharlotte says that 
Charlotte’s horizontal position is wiggle. 

In the physical universe, objects move as a consequence of 
forces. As Newton explained, force leads to acceleration, ac¬ 
celeration to velocity, and velocity to position. With computer 
animation, you have the freedom to ignore the laws of our 
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Figure 1: leftRightCharlotte moves Charlotte from side to side. 
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Figure 2: Patrick moving up and down. 


universe. However, since animations are usually intended to 
be viewed by and interacted with by inhabitants of our own 
universe, they are often made to look and feel real by emu¬ 
lating Newtonian laws or simplifications and variations on them. 

The key idea underlying Newton’s laws and their variations 
is the notion of an instantaneous rate of change. Fran makes 
this notion available in animation programs. To illustrate rate- 
based animation, you can make Becky move from the left edge 
of the viewing window, toward the right, at a rate of one dis¬ 
tance unit per second; see Figure 5 and Listing Seven. 

The local definition of x here (introduced as a where clause), 
follows a style you’ll see in the following definitions. To express 
an animated value that starts out with a value xO and grows at 
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Figure 3: Combining Charlotte and Patrick. 
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(continued from page 20) 

a rate of r, you say xO + atRate r u. Here u is a “user”, which is 
a Fran value that contains all user input and display update 
events. Rate-based animations require a user argument in order 
to give atRate a way of knowing when to start and how pre¬ 
cisely to calculate value from rate. Unlike previous examples, 
this one can be displayed with displayU. To see this example, 
enter displayU velBecky. 

In Listing Seven, Becky has a constant velocity, but with a lit¬ 
tle more effort you can give Becky a constant acceleration by 
providing a constant value for the rate of change of the veloci¬ 
ty; see Listing Eight. In the definition of v, the “0 +” is unnec¬ 
essary, but emphasizes that the initial velocity is zero. 

The notion of “rate” is useful not just in one dimension, but 
in two and three dimensions as well. In Listing Nine, I control 
Becky’s 2D velocity with the mouse. When you hold the mouse 
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Figure 4: Defining new animation functions. 



Figure 5: Rate-based animation at a rate of one distance 
unit per second. 


cursor at the center of the view window, Becky stays still. As 
you move away from the center, imagine an arrow from the 
window’s center to the mouse cursor. Becky moves in that di¬ 
rection and her speed will be equal to the arrow’s length. This 
kind of imaginary arrow is referred to as a “vector” and is the 
same type of quantity as a two- or three-dimensional offset, ve¬ 
locity, or acceleration. In 2D, a vector can be thought of as hav¬ 
ing horizontal and vertical (X and Y) components, or as having 
a magnitude (length) and direction. This time, I use move , a vari¬ 
ant of moveXY that takes a 2D offset vector. (If a vector v is x 
units horizontally and y units vertically, then “move v im” is 
equivalent to “moveXY x y im.”) The offset vector starts out as 
the zero vector, and grows at a rate equal to mouseMotion , which 
is the offset of the mouse cursor relative to the origin of 2D 
space (which you see in the center of the view window). 

In the real world, the position of an object may affect its speed 
or acceleration. In Listing Ten, Becky is chasing the mouse cur¬ 
sor. The further away it is, the faster she moves. The only dif¬ 
ference from Listing Nine is that the velocity is determined by 
where the mouse cursor is relative to Becky’s own position, as 
indicated by the vector subtraction. 

For fun, you can generalize the beckyChaseMouse function in 
the same way that hvDance generalized charlottePatDance ear¬ 
lier; see Listing Eleven. Then chaseMouse becky is equivalent to 
beckyChaseMouse , as you can verify by typing displayU (chase¬ 
Mouse becky) at the Hugs prompt. 

For more fun, try the same, but replace becky with some of the 
animations that appeared earlier ( leftRightCharlotte , charlottePat¬ 
Dance , and patOrbitsCharlotte ); see Figure 6 and Listing Twelve. 

Next make a chasing animation that acts like it is attached to 
the mouse cursor by a spring. The definition is similar to becky¬ 
ChaseMouse. In Listing Thirteen, however, the rate is itself chang¬ 
ing at rate accel (acceleration). This acceleration is defined like 
the velocity was in the previous example, but this time, some 


Listing Seven 

velBecky u = moveXY x 0 becky 
where 

x = -1 + atRate 1 u 

Listing Eight 

accelBecky u = moveXY x 0 becky 
where 

x = -1 + atRate v u 
v = 0 + atRate 1 u 

Listing Nine 

mouseVelBecky u = move offset becky 
where 

offset = atRate vel u 
vel = mouseMotion u 

Listing Ten 

beckyChaseMouse u = move offset becky 
where 

offset = atRate vel u 

vel = mouseMotion u - offset 

Listing Eleven 

chaseMouse im u = move offset im 
where 

offset = atRate vel u 

vel = mouseMotion u - offset 

Listing Twelve 

danceChase u = 

chaseMouse (stretch 0.5 charlottePatDance) u 

Listing Thirteen 

springDragBecky u = move offset becky 
where 

offset = atRate vel u 
vel = atRate accel u 

accel = (mouseMotion u - offset) - 0.5 * A vel 
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(continued from page 22) 

drag is also added. This tends to slow down Becky by adding 
some acceleration in the direction opposite to her movement. 
(Increasing or decreasing the “drag factor” of 0.5 in Listing Thir¬ 
teen creates more or less drag.) The operator *a multiplies a 
number by a vector, yielding a new vector that has the same di¬ 
rection as the given one but a scaled magnitude. 

As usual, these declarative animation programs are straightfor¬ 
ward because they say what the motion is, in high-level, contin¬ 
uous terms, without struggling to accommodate the discreteness 
of the computer used to present them. In contrast, imperative an¬ 
imation programs must explicitly simulate rate-based animation 
by making lots of discrete steps — accumulating approximations 
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Figure 7: Composition-in-time. Defining an orbiting 
animation, and then combining it with a version of itself 
delayed by one second. 
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Figure 6: Rate-based animation, but replacing Becky with 
animations such as leftRightCharlotte, charlottePatDance, and 
patOrbitsCharlotte. 
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to the continuously varying forces, accelerations, and velocities— 
to approximate motion. Doing an accurate and efficient job of 
all this approximation work is a tricky task. With systems like 
Fran, you just describe the continuous motion in terms of con¬ 
tinuously varying rates, and trust Fran to do a good job with 
the approximation. (Not good enough to fly an airplane or 
control dangerous machinery, but good enough for an effec¬ 
tive illustration or game.) 

Composition-in-Time 

Operations such as over and move support the principle of 
composition-in-space. Composition-in-time is equally valuable. 
Figure 7 and Listing Fourteen, for instance, define an orbiting 
animation, and then combine it with a version of itself delayed 
by one second. Instead of delaying, you can speed it up; see 
Listing Fifteen. You can even delay or slow down animations in¬ 
volving user input. In Listing Sixteen, one Jake tracks the mouse 
cursor, while the other follows the same path, but delayed by 
one second. 

Next you can build an animated sentence, following the mouse’s 
motion path. As a preliminary step, use delayAnims dt anims = 
overs (zipWith later[0, dt..]anims) to define a delayAnims func¬ 
tion, which takes a time delay dt and a list anims of animations, 
and yields an animation. Each successive member of the given 
animation list is delayed by the given amount after the previous 
member. The definition of delayAnims introduces a few new Fran 
elements. The Fran overs function is like over , but applies to a list 
of animations rather than just two. Animations earlier in the list 
are placed over ones later in the list. The notation [0, dt...] means 
the infinite list of numbers 0, dt, 2 dt, 3 dt , and so on. Finally, 
zipWith applies to a given two-argument function the successive 
values from two given lists. You use it here to delay the first an¬ 
imation in anims by 0 seconds, the second by dt seconds, the 
third by 2 dt seconds, and so on. Finally, overs combines them 
into a single animation. Figure 8 and Listing Seventeen present a 
simple use of delayAnims. Next, use delayAnims (Listing Eigh¬ 
teen) to define mouseTrailWords that makes animated sentences. 

The Haskell words function takes a string apart into a list of 
separate words. The Haskell map function takes a function (move- 
Word ) and a list of values (the separated words) and makes a 

Models versus 
Presentations 

I I ere is a rough sketch of the steps you usually go through 
U to program an animation: 

Allocate and initialize window, various drawing surfaces and bitmaps 
repeat until quit: 
get time (t) 
clear back buffer 
for each sprite (back to front): 
compute position, scale, etc. at t 
draw to back buffer 
fast copy ("blit") back buffer to front 
Flip back buffer to the screen 

Deallocate bitmaps, drawing surfaces, window 

These steps are usually carried out with lots of tedious, low- 
level code you have to write yourself . Most of this work is not 
about what the animation is, but how to present it. In con¬ 
trast, Fran programs are only about what the animation is. 

— C.E. 


Listing Fourteen 

orbitAndLater = orbit 'over' later 1 orbit 
where 

orbit = moveXY wiggle waggle jake 

Listing Fifteen 

orbitAndFaster = orbit 'over' faster 2 orbit 
where 

orbit = move wiggle waggle jake 

Listing Sixteen 

followMouseAndDelay u = 

follow 'over' later 1 follow 
where 

follow = move (mouseMotion u) jake 

Listing Seventeen 

kids u = 

delayAnims 0.5 

(map (move (mouseMotion u)) 

[jake, becky, charlotte, pat3) 



trailWords motion str = 

delayAnims 1 (map moveWord (words str)) 
where 

moveWord word = move motion ( 
stretch 2 ( 

withColor blue (stringlm word), )) 

Listing Nineteen 

flows u = trailWords motion 

"Time flows like a river" 

where 

motion = 0,7 * A vector2XY (cos time) 

(sin (2 * time)) 


Listing Twenty 

flows2 u = trailWords (mouseMotion u) 

"Time flows like a river" 


Listing Twenty-One 

redBlue u = buttonMonitor u 'over' 
withColor c circle 

where 

c = red 'untilB' Ibp u -=> blue 

Listing Twenty-Two 

redBlueCycle u = buttonMonitor u 'over' 

withColor (cycle red blue u) 
circle 

where 

cycle cl c2 u = 

cl 'untilB' nextUser_ Ibp u ==> cycle c2 cl 


Listing Twenty-Three 

tricycle u = 

buttonMonitor u 'over' 
withColor (cycle3 green yellow red u) ( 
stretch (wiggleRange 0.5 1) 
circle ) 

where 

cycle3 cl c2 c3 u = 
cl 'untilB' nextUser_ Ibp u ==> 
cycle3 c2 c3 cl 

Listing Twenty-Four 

jumpFlower u = buttonMonitor u 'over' 

moveXY (bSign u) 0 flower 
flower = stretch 0.4 

(importBitmap "../Media/rose medium.bmp") 
bSign u = selectLeftRight 0 (-1) 1 u 


Listing Twenty-Five 

growFlower u = buttonMonitor u 'over' 

stretch (grow u) flower 

grow u = size 
where 

size = 1 + atRate rate u 
rate = bSign u 

Listing Twenty-Six 

growFlowerExp u = buttonMonitor u 'over' 

stretch (grow’ u) flower 

grow’ u = size 
where 

size - 1 + atRate rate u 
rate = bSign u * size 
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new list by applying the function to each member of the list. The 
Fran stringlm function makes a picture of a string. I define the 
function moveWord locally to be the result of making a picture 
of the given word, using the Fran stringlm function, and moving 
it to follow the mouse. delayAnims then causes each of these 
mouse-following word pictures to be delayed by different amounts. 
Figure 9 and Listing Nineteen is a use of trailWords following a 
specified path, while Listing Twenty follows the mouse. 

Reactive Animation 

The animations presented to this point can be called “nonreac¬ 
tive” since they always do the same thing. A “reactive” anima¬ 
tion, on the other hand, involves discrete changes due to events. 
To illustrate, you can make a circle that starts off red and changes 
to blue when the left mouse button is pressed. 

An informal reading of the last line of Listing Twenty-One (also 
see Figure 10) is that the color c is red until you press the left mouse 
button, then becomes blue. For a more literal reading, you must 
understand that there are really two new binary infix operators 
here— untilB and -=>—which can be used separately or togeth¬ 
er. Implied parentheses are around Ibp u -=> blue. The -=> opera¬ 
tor, which can be read as “handled by value,” takes an event (Ibp 
u) and a value (blue), and yields a new event. In this case, the new 
event happens when the left button is pressed, and has value blue. 
The untilB operator takes an animation of any type (the color¬ 
valued constant animation red), and an event (Ibp u -=> blue), 
whose occurrence provides a new animation of the same type. 

Cyclic Reactivity 

To make Figure 10 more interesting, you can switch between 
red and blue every time the left button is pressed. As Listing 
Twenty-Two shows, you do this with the help of a cycle func¬ 
tion that takes two colors (cl and c2) and gives an animated 
color that starts out as cl. When the button is pressed, it swaps 
cl and c2 and repeats (using recursion). 

Listing Twenty-Two uses the operator ==>, which is a vari¬ 
ant of -=>. This operator (which can be read as “handled with 
function”) takes an event and function f. It works like -=>, but 
gets event values by applying/to event values from the event 
given to it. In this case,/is the cycle function applied to just two 
arguments, leaving the third (a user) to be filled in automatical¬ 
ly (using ==>). The nextUser_ function turns Ibp into an event 
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Figure 8: Composition-in-time using delayAnims. 
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(continued from page 26) 

whose occurrence information is a new user, corresponding to 
the remainder of the user u. The color arguments get swapped 
each time “around the loop.” 

For variety, Listing Twenty-Three uses three colors, and changes 
the circle’s size smoothly. 

Selection 

Figure 11 and Listing Twenty-Four present a flower that starts 
out in the center and moves to the left or right when the left or 
right mouse button is pressed, returning to the center when the 
button is released. 

The function bSign is defined to be -1 when the left button 
is down, +1 when the right button is down, and 0 otherwise 
(thanks to selectLeftRight ). You can use bSign to control the rate 
of growth of an image. In Figure 12 and Listing Twenty-Five, 
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Figure 9: Using trailWords following a specified path. 
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Figure 10: The color c is red until you press the left mouse 
button, then it becomes blue . 


pressing the left (or right) button causes the image to shrink (or 
grow) until released. Put another way, the rate of growth is 0, 
-1, or 1, according to bSign. A simple change to the grow func¬ 
tion (Listing Twenty-Six) causes the image to grow or shrink at 
a rate equal to its own size. selectLeftRight , used to define bSign , 
is also the key ingredient in defining buttonMonitor (Listing 
Twenty-Seven), which gives button feedback. 

stringBIm turns an animated string into an image animation, 
which here gets enlarged, colored white, and moved down by 
a little less than half the window height. 

selectLeftRight can itself be defined in terms of more basic 
functions, as in Listing Twenty-Eight. You use the conditional 
function condB to say that if the left button is down, use the 
left value, or if the right button is down, use the none value; 
otherwise use the none (constants, which turns constants— 
nonanimations—into animations that never change). 
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(continued from page 28) 

3D Animation 

Declarative animation applies to 3D as well, and the 2D opera¬ 
tions Fve used to this point— importBMP, moveXY, and stretch — 
have 3D counterparts. As a first 3D example, sphere = importX 
"../Media/sphere2.x" defines a sphere in which the function im¬ 
portX brings in a 3D model in “X-file” format, as used by Mi¬ 
crosoft’s DirectX. It is just as easy to import a teapot; see Figure 
13 and Listing Twenty-Nine. I used stretchy (a 3D counterpart to 
stretch ) because the imported model was too small. Listing Thir¬ 
ty colors the teapot and makes it spin around the 2 - (vertical) axis. 

Next, you can use the mouse to control the teapot’s orienta¬ 
tion. To do this, define mouseTurn to turn a given geometry g 
around the x-axis according the mouse’s vertical movement, and 
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Figure 11: Flower starts in the center and moves to the left 
or right when the left or right mouse button is pressed, 
returning to the center when the button is released. 
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Figure 12: Pressing the left (or right) button causes the 
image to shrink (or grow) until released. 


around the 2 -axis according the mouse’s hori2ontal movement, 
scaled by tt Finally, as Figure 14 and Listing Thirty-One show, 
you apply mouseTurn to a green teapot. 

You can also make teapots spin by controlling the rotation 
angle with the grow function, as in the growing flower exam¬ 
ples. First, define spinPot, see Listing Thirty-Two, that takes 
(animated) color and angle and yields a colored, turning teapot. 
Then make a pot that spins one way when the left button is 
pressed, and the other way when the right button is pressed, 
using the grow function, and giving feedback with button- 
Monitor, see Figure 13 and Listing Thirty-Three. renderGeom- 
etry, used here with a convenient default camera, turns a 3D 
animation into a 2D animation. 

Additional spinning teapots will all have the general form of 
using the button monitor and rendering with the default cam¬ 
era. Rather than having to write several definitions, give the pat¬ 
tern a name. In Listing Thirty-Four, withSpinner takes a func¬ 
tion as its first argument, and applies that function to the result 



Figure 13: Importing a teapot. 
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(continued from page 30) 

of the grow function applied to the user argument. With this def¬ 
inition, you can write spinl more simply; see Listing Thirty-Five. 
Another use of withSpinner is to make the color vary in hue 
and use the value from grow to determine the time-varying speed 
of rotation, so that the mouse buttons cause the turning to ac¬ 
celerate and decelerate (see Listing Thirty-Six). 

In addition to visible geometry, you can add lights to a 3D 
model. In Listing Thirty-Seven, you combine a white sphere, 
which is visible but does not emit light, and a point light 
source, which is invisible but emits light. You color the 
sphere/light pair white, shrink it, and give it motion. For con¬ 
venience, you express the motion path in terms of spherical 
coordinates, saying that the distance from the origin of space 
(which is also the center of the teapot) is always 1.5 units, the 
longitude is n times the elapsed time, and the latitude is twice 
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Figure 14: Applying mouseTurn to a green teapot. 
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Figure 15: Making teapots spin by controlling the rotation 
angle with the grow function. 


it times the elapsed time. Consequently, you get a motion that 
meanders about, but maintains a fixed distance from the cen¬ 
ter of the teapot. 

Just for fun, replace the single moving light with five. A sim¬ 
ple change suffices, if you add delayAnims3 — a 3D variant of 
the 2D delayAnims. As Listing Thirty-Eight shows, the difference 
is that in the 3D version, you use unionGs instead of overs. With 
this function, you make a list of five copies of the moving light 
(see Listing Thirty-Nine), using the predefined Haskell function 
replicate , stagger them in time with delayAnims3, and combine 
them with a green teapot. Then slow down the animation to see 
it more clearly. 

In Listing Forty and Figure 16 (a moving trail of colored balls), 
you define a single ball having a spiral motion, which traces the 
surface of an unseen sphere of radius 1.5 with a longitude an¬ 
gle changing ten times as fast as the latitude angle (five versus 
one-half radians per second). From this one moving ball, you 
make ten balls, each a differently colored version, and then stag¬ 
ger them in time with delayAnims3. The coloring function bCol- 
or produces evenly spaced hues. 

As a final 3D example, Listing Forty-One presents another spi¬ 
ral. This time you form a static spiral, then turn it about the z-axis. 


Listing Forty 

spiral3D = delayAnims3 0.075 balls 
where 

ball = move3 motion (stretch3 0.1 sphereLowRes) 
balls = [ withColorG (bColor i) ball 
! i <- [1 .. n] ] 

motion = vector3Spherical 1.5 (10*time) time 
n =20 

bColor i = 

colorHSL (2*pi * fromlnt i / fromlnt n) 0.5 0.5 

Listing Forty-One 

spiralTurn = turn3 zVector3 (pi*time) (unionGs (map ball [1 .. n])> 
where 
n = 40 

ball i = withColorG color ( 
move3 motion ( 
stretch3 0.1 sphereLowRes )) 

where 

motion = vector3Spherical 1.5 (10*phi) phi 
phi = pi * fromlnt i / fromlnt n 
color = colorHSL (2*phi) 0.5 0.5 
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Figure 16: A moving trail of colored spheres. 
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Related Work 

My interest in functional animation originally started with Kavi 
Arya’s “A Functional Approach to Animation,” Computer Graph¬ 
ics Forum, 5(4):297-311 (December, 1986). Although elegant, 
Arya used a discrete model of time. The TBAG system, on the 
other hand, used a continuous time model, and had a syntactic 
flavor similar to Fran’s; see “TBAG: A High Level Framework for 
Interactive, Animated 3D Graphics Applications,” by Conal El¬ 
liott, Greg Schechter, Ricky Yeung, and Salim Abi-Ezzi (Pro¬ 
ceedings of SIGGRAPH ’94 July, 1994). Unlike Fran, reactivity 
was handled imperatively. Behaviors were created by means of 
constraint solving, and updated through constraint assertion and 
retraction. Concurrent ML introduced a first-class notion of events 
that can be constructed compositionally; see “CML: A Higher- 
order Concurrent Language,” by John H. Reppy (Proceedings of 
the ACM SIGPLAN ’91 Conference on Programming Language 
Design and Implementation, 1991). However, those events per¬ 
form side-effects such as writing to buffers or removing data 
from buffers. In contrast, Fran event occurrences have associat¬ 
ed values—they help define what an animation is, but do not 
cause any side effects. 

For examples of DirectAnimation, see http://www.mi- 
crosoft.com/ie/ie40/demos and “Adding Theatrical Effects to Ev¬ 
eryday Web Pages with DirectAnimation,” by Salim AbiEzzi and 
Pablo Fernicola (Microsoft Interactive Developer, October 1997). 

For background on Haskell, see Introduction to Functional 
Programming, by Richard Bird and Philip Wadler, (Prentice-Hall, 
1987), “A Gentle Introduction to Haskell,” by Paul Hudak and 
Joseph H. Fasel, SIGPLAN Notices, 27(3), May, 1992, and 
http://haskell.org/tutorial/index.html. 

For information on Fran, refer to “Functional Reactive Anima¬ 
tion,” by Conal Elliott and Paul Hudak, Proceedings of the 1997 


ACM SIGPLAN International Conference on Functional Program¬ 
ming (June, 1997), or the Fran web page at http://www.research 
.microsoft.com/mconal/Fran. 

Conclusion 

For interactive animation to expand into its potential as a medi¬ 
um of communication, it must become much easier to program. 
As this article illustrates, one step toward this goal is the re¬ 
placement of imperative techniques (“how to do”) with declar¬ 
ative ones (“what to be”). 

There are several features I haven’t explored here, including 
sound, smooth flip-book animation, and cropping. There are 
also many opportunities for improvement: more features for 2D, 
sound, and 3D; improved efficiency; generation of animation 
“software components” to integrate with components written in 
more mainstream programming languages; and support for dis¬ 
tributed, multiuser scenarios. 
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A Conversation with 

John Knoll 


Life on the bleeding edge 
of computer graphics 

Thomas "Rick" Tewell 

A s a visual effects supervisor for 
George Lucas’ Industrial Light & 
Magic, John Knoll has lived on the 
bleeding-edge of computer graph¬ 
ics for over a decade. As such, he has 
worked on ground-breaking feature films 
such as The Abyss (which earned an 
Academy Award for Best Visual Effects), 
Mission Impossible , and Star Trek VIII: 
First Contact , among many others. He is 
currently working on the next Star Wars 
film, currently codenamed Episode I. In 
addition, John and his brother Tom are 
the creators of Adobe’s Photoshop image- 
processing software. John recently took 
time from his duties at Industrial Light & 
Magic in Marin County, California, to chat 
with Rick Tewell. 

DDJ: John, from what I understand, you 
transitioned from model-making into com¬ 
puter graphics. Can you tell us about that? 
JK: Sure. When I was a kid, model¬ 
making was a hobby of mine. I got to be 
reasonably good at it and decided to go 
into visual effects as a career. I moved to 
Los Angeles to attend the University of 
Southern California film program. At USC, 

I tried to make contacts so that when I 
graduated, I wouldn’t be going into an 
entry-level position. I was trying to get 
some of those entry-level-position years 

Rick works for Sequoia Advanced Tech¬ 
nologies . He can be contacted at thomas 
. tewell@seqadvtech . com . 


behind me while in school. So I started 
doing freelance model work. 

DDJ: Creatures or vehicles? 

JK: Mostly the hard surface kinds of 
things. The first guy I worked for was Greg 
Jean who has a model shop. Since he ains 
a low-budget operation, he was happy to 
hire newbies and train us. 



When the model was done, I’d take it 
out to the stage and fix things—during 
rigging, they’d need a hole here or some¬ 
thing has got to move or I had to paint 
something to fix it because it didn’t look 
good enough for camera. Somebody has 
to be around to do those sorts of things. 
So I would be on the stage a lot of the 
time when my models would be shot, 
which meant I got familiar with motion- 
control cameras. That was something that 
interested me. How do you get started do¬ 
ing that sort of thing? They didn’t teach 
that at USC, which was mostly a live-ac¬ 
tion school. My last year at USC, I took 
an advanced animation class and we had 
a couple of manual hand-cranked ani¬ 
mation stands. For my final project, I de¬ 


cided to build a simple four-channel mo¬ 
tion-control system. This was in 1984. I 
bought a used Apple II and a four-chan¬ 
nel serial-controlled CNC milling machine, 
which ran four stepper motors. And I 
bought a bunch of surplus stepper mo¬ 
tors from C&H Sales and various bits and 
pieces. Although the camera got booked 
in two-hour blocks during the week, it 
was free during the weekend. Conse¬ 
quently, after the last session on Friday 
night, I could go in there, take the hand- 
cranks off, bolt my motors on, set up the 
computer, and shoot as long as I had it 
all cleared off by the first scheduled block 
on Monday. It was a lot of fun. 

DDJ: This was an Apple II? 

JK: An Apple II Plus with a whopping 
64K of RAM. I had a digital I/O board so 

I could control various relays. 

DDJ: So primarily, you were using the 
Apple II to do the motion control, and the 
camera was just a regular film camera? 
JK: Yeah. What I was shooting was slit 
scan. It was a process I read about and 
was fascinated with and I wanted to try 
it. You really need a computer to control 
that stuff. 

DDJ: Did you write the software for the 
Apple II? 

JK: Yes. 

DDJ: So you were familiar with pro¬ 
gramming at that time? 

JK: A little. Actually, before I started at 
USC (in 1980), my dad got an Apple II as 
part of his university research work. After 
dinner, he’d go work on his research but 
he encouraged my brother Tom and I to 
play with it. This was in 1978. 

The wonderful thing about the Apple 

II was it had this Basic interpreter built 
into ROM, so all you had to do was turn 
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(continued from page 34) 
the computer on and start typing in lines. 
That was a lot of fun. I feel privileged that 
one of my first exposures to computers 
was when they were so simple. There was 
only so much that these really primitive 
computers could do, so it didn’t take a lot 
to kind of learn everything there was to 
know about them. As the computers be¬ 
came more complicated, you could learn 
gradually. I can only imagine what it’s like 
to dive into what programming is like 
now. I’ve had 20 years of exposure to it. 
Today, it’s incredibly complicated for 
somebody just coming out of school. 

DDJ: At what point did it occur to you 
that the computer could actually be a tool 
for more than motion control or camera 
control—that the computer could actu¬ 
ally be used to generate computer images 
suitable for film? 

JK: A lot of people saw it coming. I read 
about computer graphics and had friends 
who were members of SIGGRAPH so I 
saw the tapes, and was fascinated by it. 
It wasn’t really interesting enough to me 
at that point in the early ’80s. I thought it 
was neat but not ready for feature films. 
But then as it started getting close to be¬ 
ing ready, I became one of the first peo¬ 
ple pushing for it. I was computer graph¬ 
ics designer on The Abyss [circa 1989], 
which was one of the first realistic pieces 
of computer graphics in a feature film. At 
least that was our intent. 

DDJ: When did Photoshop come into play? 
JK: Actually, it was somewhat accidental. 
As I said, when I was a kid, one of my 
hobbies was model making. I got to be 
fairly good at that and it got me into the 
industry. But when model making turned 
into a profession, it sort of killed it as a 
hobby. It’s not much fun to build models 
all day, then go home and build more 
models. 

Since I was interested in motion con¬ 
trol, I got a computer and started build¬ 
ing motion-control systems for it. That be¬ 
came my new hobby. Because I knew 
people who were shooting motion-control 
elements with the models I was building, 

I began getting work as a camera assis¬ 
tant on motion-control stages. Then I got 
hired as a motion-control camera assistant 
at Industrial Light & Magic (ILM). Pretty 
soon I was doing motion control full time 
and its appeal as a hobby was greatly di¬ 
minished. 

I started at ILM in 1986 and had just 
gotten a Macintosh, my first sophisticated 
computer, and started writing little graph¬ 
ics programs as my new hobby. ILM was 
the first place I ever worked that had a 
computer-graphics department and, when 
I wasn’t working in motion control, I’d go 


there to see what they were up to. They 
had this laser film scanner, where you 
could scan in a piece of negative and gen¬ 
erate a digital image. They had the Pixar 
Image Computer, a nice high-quality frame 
buffer where you could do manipulations 
to a picture and film it back out. I had a 
demo of something so trivial now, you 
hardly even think of it. This guy brought 
up an image on the screen and simply 
sharpened it. That actually seemed mirac¬ 
ulous at the time and made a huge im¬ 
pression on me. 



Visual Effects Supervisor John Knoll 
(left) working with Senior Model 
Maker John Goodson (right) on a 
helicopter from Mission Impossible. 

About that time, my brother Tom was 
at the University of Michigan working on 
his doctoral thesis. He had pursued com¬ 
puter programming much more serious¬ 
ly; that’s what he had wanted to do for 
his career. 

He was trying to get his doctorate in 
computer vision and the first part of any 
computer vision stuff is image processing. 
He was doing his thesis work on a Mac 
Plus and writing these image-processing 
algorithms as MPW shell tools. That was 
much like how Pixar Image Computers 
worked. You typed in command-line ar¬ 
guments from a UNIX command line to 
run C-shell scripts from the Sun to con¬ 
trol the frame buffer on the Pixar. That 
was sort of the same thing Tom was do¬ 
ing on his Mac. 

I saw a lot of the similarities. Then the 
Mac II came out. It had a math coproces¬ 
sor. It had color. It was faster. It had more 
memory. I had to have it because I thought 
it was so neat. When that machine first 
came out, displaying a color image on it 
from a programming standpoint was a big 
deal. I wasn’t terribly interested in the me¬ 
chanics of the palette manager, window 
manager, and all the things that were re¬ 
quired to display a color picture. What I 


was interested in was the code that fig¬ 
ured out how bright a pixel should be. 
One of the hobby things I was doing was 
writing a little ray tracer. Tom told me to 
do the math, figure out how bright the pix¬ 
el ought to be, and just write it to disk as 
a raw image. He said I could use his tools, 
which could read a raw block of bytes on 
the disk and display it as a picture and do 
various transforms to it. 

I did this for a while, but it was cum¬ 
bersome and I thought what would be 
neat was if we just built the display por¬ 
tion of this into an application so that I 
wouldn’t have to fire up the whole MPW 
thing and run the shell tools to do this. 
One weekend, Tom spent a few hours 
bundling some of those functions in to 
this program called “Display.” Once he 
had that working, I started bugging him 
for more stuff. It was like nothing was 
ever good enough. So we started adding 
more features until it struck me that we 
should sell this. We could get an ad in the 
back of Mac World and sell it for 50 bucks. 
Tom was really skeptical. 

DDJ: Did you ever sell the product? 

JK: No. Mostly what Display did was con¬ 
versions. We had gotten it so that it could 
read several different image file formats. 
You could write several different image 
file formats and there were a couple of 
things you could do to them in the mean¬ 
time. You could convert a color image to 
black and white. 

I was completely full of naive optimism. 

I showed it to a friend of mine at Super- 
Mac, which was in alpha with a program 
called “PixelPaint.” SuperMac was seri¬ 
ously considering making us an offer to 
bundle Display with PixelPaint as a file- 
format conversion utility. They had already 
run all their spreadsheets about how many 
units they thought they were going to sell 
of PixelPaint and what kind of deal would 
they want to make with us on bundling 
this. That added up to a number that 
seemed like this was worth doing. 

I called Tom and said SuperMac was 
interested, so he scheduled two days a 
week to work on it full time. After two or 
three months, it really did a lot of things. 

It didn’t really fit in my mind as utility any 
more. It was a program in its own right 
that wanted to be sold as its own prod¬ 
uct. One day I called Tom up and told 
him that I didn’t think there would ever 
be an opportunity like this like thrown at 
our feet again. We just had to drop ev¬ 
erything to make this happen. 

Tom estimated he was six months from 
finishing his doctoral thesis. In a supreme 
act of faith, he stopped working on his 
thesis and started programming full time. 
We greatly underestimated how much 
work this was going to be. When Tom 
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(continued from page 36) 
stopped school, he figured he had about 
six months of programming and we’d 
wrap up Version 1.0 of this program, and 
he could start next semester and finish his 
thesis. Meanwhile, we’d be making some 
money. 

From the time he decided to stop school 
until Version 1.0 shipped was almost two 
years. It became much bigger than we 
thought it would, but it kept getting better 
and better. Tom is really a superb pro¬ 
grammer. He’s one of the best engineers I 
know. He just wrote this terrific, great code. 

At the time, I moved from motion con¬ 
trol over to computer graphics, so I was 
doing a lot of work on the Pixar Image 
Computers—running composites and do¬ 
ing image-processing scripts. That drove 
a lot of my input as to what kind of fea¬ 
tures ought to be in Photoshop. I would 
try to do more and more of my work in 
Photoshop and try stuff. That’s sort of how 
“feathering” got born. It was actually me 
using it for little projects that helped de¬ 
fine the feature set. 

Version 1.0 was a usable tool largely 
because I was trying to use it to solve real- 
world problems. I would run into some¬ 
thing that would just stymie me. There’s 
got to be a way of doing this, and then 
Tom would scratch his head and go, “That 
would be hard.” He would think about it 
for a while. I would talk to him a few days 
later and he would say, “I was thinking 
about that and I had this great idea.” 

I was goading him a little bit, too. I 
would say, “You know what I really want 
to do? I want to make one of these se¬ 
lections so that I can like select some area 
and then the paint only affects just the 
area selected.” Tom would say, “Oh, that’s 
going to be impossible to make that go 
real time. It’s going to be really slow.” I’d 
say “Oh, come on, Tom. I’ll bet you can 
do that.” About a week later he would 
say, “I was thinking about it, and I think 
I’ve got a way.” It was often a whole lot 
of exchanges like that where at first Tom 
thought it would be really hard, but he 
would keep thinking about it. He’s bril¬ 
liant that way, and he would come up 
with a clever solution to the problem. 

DDJ: When Photoshop was born, the in¬ 
dustry was in some interesting transitions 
in computer graphics. 

JK: Yes. We started on Photoshop in 
September of 1987.1 think 1.0 shipped in 
January of 1990. There was some time be¬ 
tween when we started and when it 
shipped. A lot of things happened in that 
time. I started working in computer graph¬ 
ics...it wasn’t until late 1988,1 think. The 
first thing I did in computer graphics was 
a Pacific Bell Smart Yellow Pages com¬ 
mercial. 


DDJ: With a Pixar? 

JK: Yeah. A Pixar Image Computer is ba¬ 
sically a frame buffer. Lucas Film Com¬ 
puter Division was working on what be¬ 
came the Pixar computer. “Pixar” adopted 
that name as the name of the company 
after George [Lucas] sold it to Steve Jobs. 

DDJ: So that was something that was in¬ 
vented and not available anywhere else 
except for here? 

JK: Right. We had two of them here that 
we used for composite work and various 

We try to use 
off-the-shelf 
software wherever 
we can 


image-processing things. On all the old 
Pixar films like Andre and Wally B [circa 
1984], they would render different parts 
of the shot as separate passes so the char¬ 
acter in the foreground would be rendered 
separate from the background. Then they 
would composite them together, and the 
tool they used to do it would be the Pixar 
Image Computer. 

DDJ: When The Abyss was created, what 
was the state of computer graphics? 

JK: In general, no one thought of com¬ 
puter graphics as something you could 
use for real on a feature film to do some¬ 
thing that looked realistic. The one ex¬ 
ception was the stained-glass man [from 
Young Sherlock Holmes , circa 1985], which 
was a pretty remarkable achievement, and 
it’s the only thing that had ever been quite 
like that to that point. Stuff like Last Star 
Fighter [circa 1984], nobody really con¬ 
sidered realistic. But I was impressed with 
stained-glass man because it had things 
like depth of field. 

Right after I started, our computer- 
graphics department had done this Star 
Trek TV [circa 1986] dream sequence with 
the floating heads. It didn’t look very re¬ 
alistic. It was intended to be a stylized 
thing. I don’t know if anybody thought 
that our tools in house were ready to do 
something super realistic. 

I remember we got the storyboards on 
The Abyss, they were these beautiful shad¬ 
ed drawings. They are really fascinating. 


The imagery was really neat. “Wow, these 
are going to be really cool shots—who¬ 
ever does this and however it gets done.” 
A lot of different approaches were being 
bandied about with things even as weird 
as stop-motion animation with clay with 
images of water projected onto it. Things 
that almost certainly never would have 
worked. 

We had just gotten an SGI with Alias, 
and Jay Riddle in the computer-graphics 
department did a little test making some 
sort of a water tentacle thing. It was not 
a sophisticated test, but he did it really 
quick. He did it, I think, overnight and 
showed it to Jim Cameron [Titanic writ¬ 
er/director] the next day. Jim was really 
surprised how quickly that had been done 
because the reputation was that comput¬ 
er graphics was really, really slow and very 
expensive and the complete antithesis of 
interactivity. You’d talk to these guys and 
they’d disappear for months, and then they 
would come back with something you 
didn’t want. “I want it to be more like. 
“Well that will be another six months.” 

DDJ: But they felt this was an intricate 
part of the film? 

JK: Jim’s position was that if the water 
tentacle sequence—while it was a bold 
thing to attempt—didn’t work or ended 
up looking terrible, he could cut it out of 
the movie and he could still make the 
movie. He wasn’t hinging the success of 
this picture on this effect working. It was 
only like 25 shots. This seemed like a huge 
number to us at the time, but it is hardly 
anything now. So we started this R&D pro¬ 
ject to do this thing, and we wrote a bunch 
of new software to do it. We switched 
over from Rays to RenderMan, which Pixar 
had just gotten going. 

DDJ: There was nothing on the street that 
could do this at the time? 

JK: No. We used the RenderMan Tender¬ 
er but we wrote custom shaders to do the 
fake refraction and get the right amount 
of reflection for fog and that sort of thing. 
We had to write the software for it to do 
the rippling of the surface and to “skin” 
it. The way it was actually done was, we 
animated a spline in space— a 3D path— 
and we had a bunch of cross sections. 
They were animated separately, so it was 
just a bunch of circles, and we scaled 
them. And then, there was a piece of soft¬ 
ware called “Skin” that would take all of 
the circular cross sections and place them 
perpendicular to the spine at particular 
points and skin the surface. 

Then there was another program that 
would let you place a bunch of 3D noise 
generators in the world, and it would take 
the patches and subdivide them into 
smaller patches and perturb all the control 
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(continued from page 38) 
vertices according to the sums of all the 
sine waves from 3D noise generators. So 
the model was created new per frame 
based on this program, so some work 
was involved. How do you do motion 
blurs when you’re actually just changing 
the model from frame to frame without 
taking one model and moving it? Some 
hacks were made. Actually it’s the same 
model, but what we’re doing is we’re 
moving these vertices from here to here. 
You would write two-root files. They con¬ 
tain all the same CVs [control vertices] and 
then there was a script called JR2R that 
would take the two-root files and make 
them look like it was one model just mov¬ 
ing from this frame to that frame. 

DDJ: Then comes Terminator 2 [circa 
199U, which has something (not quite like 
the water tentacle) but it has the Mercury 
guy and that was from James Cameron 
JK: Yeah. Jim said it was a big gamble. If 
it didn’t work, he could always cut it out 
of the picture, but based on his experience 
on The Abyss, he went much bolder on Ter¬ 
minator 2 with making a character that had 
to be done with computer graphics. And 
it had to work because if you cut that out 
of the movie, you’ve got nothing left. All 


the things of being able to change shape 
from this to that and to melt and then re¬ 
form itself. Well, the effect has to work or 
you don’t have a movie. Yeah, it was a sign 
of his faith in the technology. 

DDJ: Injumanji [circa 19931 we have the 
first computer graphics hair that actually 
flows and moves, and the depth is there, 
and it is so stunningly realistic that it was 
actually an amazing achievement for com¬ 
puter graphics. Did that require custom 
tools or was there a point where you 
could actually use off-the-shelf compo¬ 
nents to actually do this? 

JK: We try to use off-the-shelf software 
wherever we can, but a lot of things we’re 
called upon to do just can’t be done with 
off-the-shelf software. So we have a pret¬ 
ty good size software-development staff 
just to develop these tools; otherwise, 
we would just have to say, “No, we can’t 
do that.” 

DDJ: Do you still do that today? 

JK: Yeah. 

DDJ: Do producers come in and say, “We 
want to produce a film and here are the 
special effects that we want” and you just 
go, “I don’t think so.” 
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JK: Well, no. We gulp and say, “Okay, 
we can do that. Here’s the budget.” Then 
they gulp. 

You can usually spend your way out of 
just about any hole there is. If you put 
enough time and man hours into some- 
thing, there’s usually a way to do it and I 
can think of very few exceptions where 
we just have to give up and say, “No, that 
just can’t be done.” There are some things 
that would be extremely difficult and we 
could never do realistically, at least not 
yet. But most of the things we’re asked to 
do are at least within some amount of 
R&D of what we’re capable of. George 
[Lucas], on this new Star Wars picture, 
wrote a lot of things into the script with¬ 
out worrying about how the hell are we 
going to do this. He just writes things he 
thinks are neat. 

DDJ: Martin Hash has created a product 
called Animation Master and is trying to 
make a film, Telepresence, for $2 million 
which positively could not be made for 
$2 million if a studio did it based on the 
effects he wants to put in there. 

Do you see a trend coming where in¬ 
dependent filmmakers can use off-the- 
shelf components to actually have “big 
budget” special effects in films? Up to now, 
independent films have been pretty much 
lacking special effects that are just sort of 
character driven. 

JK: It’s already happening. A bunch of 
friends of mine are starting up these 
garage operations—little one-man digi¬ 
tal facilities—and they do things for TV 
shows or low-budget features. They’re able 
to do the kind of work now just at home 
with PCs. It used to be that you had to 
have the whole full-blown production 
mechanism here for it, and now you can 
do some pretty good looking stuff. 

DDJ: Like Electric Image? 

JK: Yeah. With Electric Image, After Ef¬ 
fects, and Photoshop, you’ve got a little 
production facility there. 

DDJ: Speaking to a peer programming 
audience, what do you see as the next 
generation of products for computer 
graphics? 

JK: Well, I don’t think there are any real 
specifics that are easy to predict. But I 
think the general trend is to try and elim¬ 
inate as much machinery between the 
artist and the art as possible. 

One of the things that has been real¬ 
ly liberating about moving to digital- 
production techniques is that it used to be 
that huge amounts of effort went into just 
the mechanics of not getting the matte line 
or not getting the wrong color in a shot, for 
instance. That’s where a lot of your energy 
went—just trying to get rid of the really 
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(continued from page 40) 
obvious things. Now, you can take that stuff 
more for granted. Today, an artist spends 
more time working on the aspects of the 
work that make the shot look good or not 
look good, and not so much on the me¬ 
chanical. I see that trend continuing. 

Right now, my biggest complaint about 
the way that a lot of these digital tools 
work is that they’re still kind of awkward, 
and the artist spends too much time work¬ 
ing on things that have nothing to do with 
the shot looking good or not. It’s editing 
exclusion lists and making sure your alias¬ 
es are pointing to the right directories. 
There’s a lot of machinery that the artist 
still has to deal with that, as software gets 
better, they’re going to spend less of their 
time of doing and more of their time fo¬ 
cused on the real art of it. 

DDJ: What about these new digital inter¬ 
faces like FireWire? Do you see that again 
liberating artists so that digital images can 
go straight into the machine? 

JK:I think that all these technologies like 
this are wonderful. I spend a lot of my time 
living on the bleeding edge, where we’re 
just trying to get something done almost no 
matter how painful it is. We work with these 
kind of kludgy custom-written things that 
just barely work well enough to get through 
the shot or you really wouldn’t want to do 
that a whole lot more. And what happens 
is that like five years down the line, the com¬ 
mercial applications end up with a lot of 
functionality that we have very painstakingly 
hand crafted—like morphing, for example. 

Back on Willow [circa 1988], Doug Smythe 
spent time writing the first morphing pro¬ 
gram that worked well for what we did and 
let us do these shots that were sort of im¬ 
possible otherwise. We made good use of 
it. I used it on The Abyss to actually do the 
face animation with morphing. We used it 
on Terminator 2. Then Elastic Reality hit the 
market and once that capability was present 
in the commercial program, it was at least 
as good as our morph program. In some 
ways, it was better, and there was no rea¬ 
son to keep working on our program. 

A commercial application now had the 
same functionality, and you could buy it 
for nothing. That’s a good example of 
something that we sort of suffer through 
getting the first version, and then people 
see the results of that, and they go, “Oh, 
man, I want this.” So a bunch of com¬ 
mercial developers can jump in and say, 
“Well we can provide that.” They write a 
good interface on it, on something that’s 
actually debugged with appropriate error 
messages and all those kinds of things that 
commercial software brings to the equa¬ 
tion. And then it’s available to everybody. 

DDJ 
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A Windows 
3D Model Viewer 
for OpenGL 


Combining Win32 
with OpenGL 

Jawed Karim 

O penGL is known in the UNIX 
world as the 3D API behind high- 
powered scientific applications. It 
has recently gained attention in the 
PC sector, thanks to the computer-game 
industry, which has embraced OpenGL 
as an API standard for 3D game pro¬ 
gramming. Furthermore, 3D hardware 
acceleration for PCs has extended the 
range of applications for OpenGL even 
further. 

The OpenGL API is intuitive, easier to 
use, in my opinion, than Microsoft’s Di- 
rect3D API, and is portable among plat¬ 
forms. In this article, I’ll present a mod¬ 
el viewer for use with OpenGL on 
Windows 93/NT. First, however, I’ll de¬ 
scribe the important parts of a Quake2 


Jawed studies computer science at the Uni¬ 
versity of Illinois at Urbana-Champaign. 
He works part-time at the National Cen¬ 
terfor Supercomputing Applications, and 
can be contacted at jkarim@students 
. uiuc.edu . 


model viewer— an OpenGL-based sys¬ 
tem written in C/C++—that displays 
wire-frame and texture-mapped models 
(see Figure 1) from Quake2 and provides 
a basic interface to modify their appear¬ 
ance. In the process, I’ll focus on file for¬ 
mats (MD2 files for models, and PCX files 
for textures), passing the data contained 
in the files to OpenGL for rendering, and 
interfacing Win32 with OpenGL using an 



API called “WGL.” The archive Q2M- 
SRC.ZIP contains the Quake2 Model 
Viewer source code, while Q2M-BIN.ZIP 
is the Quake2 Model Viewer EXE file. 
Both are available electronically; see “Re¬ 
source Center,” page 3. 


Reading the MD2 File Format 

The only official source of information 
about Quake2’s MD2 format is code by 
John Carmack of id Software; this code 
writes 3D polygon mesh data to an MD2 
file (available at ftp://ftp.idsoftware.com/). 
Anyone who has looked at this source 
code will notice that some of the structs 
in Quake2 Model Viewer’s md2.h (avail¬ 
able electronically) are derived from it. 
Writing the MD2 reader basically involves 
converting John’s code from reading MD2 
files to writing them. Figure 2 illustrates 
the binary staicture of an MD2 file. 

To display the textured Quake2 mod¬ 
els, four specific types of information are 
needed (see Figure 3): 

• 3D vertex coordinates. 

• A list of triangles consisting of those 
vertices. 

• 2D texture vertex coordinates (one for 
each 3D vertex). 

• The texture image. 

All of the 3D vertices in the model are 
stored in one array. When the triangles 
(which are made up of those vertices) 
are defined, all that has to be stored for 
each vertex of a triangle is an index num¬ 
ber to the big vertex array. The reason 
for this is simple: Since many of the ver¬ 
tices are shared between triangles, stor¬ 
ing each vertex once saves memory. In 
addition, linear transformations can be 
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(continued from page 44) 
performed on the entire array at once, 
thereby speeding rendering time. Since 
the texture image itself is not a part of 
the' MD2 file, it can be read in from a 
conventional PCX file. 

Before starting, you must know how 
much data to expect. The file’s header sec¬ 
tion tells you the number of vertices, tri¬ 
angles, and texture coordinates contained 
in the file. Knowing when to stop, you 
can go into a loop and read the informa¬ 
tion in chunks. To store all the data, use 
the vertex structure in Listing One (list¬ 
ings begin on page 96). 

Each triangle is defined by its corners, 
a , b, and c. These values are indices to 
an array of type make_vertex_list, which 


is a list of all 3D vertices in the entire mod¬ 
el. The remaining six integers represent 
the 2D texture coordinates for every ver¬ 
tex. Listing Two is an example of a struc¬ 
ture for holding this data. Using such a 
structure, the coordinates of the three ver¬ 
tices of the first triangle in the model can 
be referenced (see Listing Three). 

In a Quake2 model, the only things that 
differ from one frame to the next are the 
3D coordinates of the triangle vertices; the 
vertex indices and texture coordinates re¬ 
main the same. From frame to frame, each 
triangle still consists of the same three ver¬ 
tices— only the vertices undergo linear 
transformations. To hold each frame in an 
array, you create another array of type 
make_frame_list (Listing Four), each of 



Figure 1: The 3D model viewer in 
action. 


which contains an array of vertex coordi¬ 
nates (Vertex 1, 2, and 3, respectively). 
There exists one copy of this array for 
each frame. Having filled all of the data 
structures, you can look up the coordi¬ 
nates of any polygon in any frame; see 
Listing Five (the coordinates of polygon 
P in frame F). 

Texturing the Object 

Quake2’s model textures reside as sepa¬ 
rate PCX files, either in the pakO.pak file 
or quake2/baseq2 directory. Since Open- 
GL itself does not provide a way to read 
the binary PCX graphics file format, you 
can read the PCX file and pass its data to 
OpenGL. 

Figure 4 describes the PCX format. The 
three basic sections in the file are the 
header, pixel data, and palette data. You 
can use two arrays of type unsigned char 
to store the last two sections. The head¬ 
er contains some basic information about 
the particular file, such as the PCX ver¬ 
sion, and the file dimensions. If the file is 
actually a PCX Version 3 file, the first two 
bytes in the file must be equal to 10 and 
5, respectively. Having determined the im¬ 
age dimensions from the header section, 
you dynamically allocate an array of type 
unsigned char of size(width*height) for 
the pixel data and read it into the buffer 
byte-by-byte. Because a Version 5 PCX 
file can support exactly 256 colors, the 
size of the palette section is always 768 
bytes (3*256, or RBG*256). 

When the CImager.Read (char file- 
name[]) function is finished, the m_pix- 
eljbuffer array is filled with all the pixels 
in the image, and m_palette_buffer con¬ 
tains consecutive RGB values for each of 
the colors. 

How do you get the color of a specif¬ 
ic pixel in the image? The pixel buffer sim¬ 
ply contains index values of the palette 
buffer. Listing Six shows two methods. 
The R, G, and B components of the first 
pixel (pixel zero) in the image are Listing 
Six(a). However, because the palette ar¬ 
ray contains consecutive RBG values 
(RGBRGBRGBRGB...) for all the colors, 
the individual R, G, and B values at pix¬ 
el position P are obtained by properly off¬ 
setting the array index; see Listing Six(b). 
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Figure 2: The binary structure of an MD2 file. 


Figure 3: The types of information needed to display textured Quake2 models. 
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Finally, to be able to reference color val¬ 
ues at specific (X,Y) coordinates in the 
texture, P is substituted by X+Y* Width, 
where Width is the width of the texture; 
see Listing Six(c). 

OpenGL 

Once the necessary data is organized and 
stored in memory, you can start render¬ 
ing using OpenGL. But first, some of 
OpenGL’s texturing options must be set. 
In particular, you must specify how to treat 
textures when wrapped and indicate the 
“minification” and magnification filters 
(Listing Seven). 

In addition, back-face culling and tex¬ 
turing have to be explicitly enabled. Since 
you won’t be looking at the backsides of 
polygons, you only have to enable front¬ 
side filling of polygons. Lastly, you spec¬ 
ify the texture function (Listing Eight). 

OpenGL’s glTexhnage2D() is the func¬ 
tion that actually textures the object. It ex¬ 
pects to be passed, among other param¬ 
eters, a pointer to an array containing 
successive RGBA values for each pixel in 
the texture (for example, RGBARGBA- 
RGBA...). 

Thus, before calling glTexImage2D(), 
two changes must be made: 

1. The pixel and palette data read from the 
PCX file must be copied into another 
array, of a format that glTexImage2D() 
can accept as a parameter. 

2. Because OpenGL requires the dimen¬ 
sions of a texture to be powers of two, 
the texture has to be rescaled first us¬ 
ing gluScaleImage(). 

Both of these steps are accomplished 


in CImage::Image2GLTexture(), which 
first creates a new array called unScaled, 
fills it with RGBA components, and 
rescales it to an appropriate size. The loop 
in Listing Nine fills a new array with 
RGBA components of each pixel in the 


WGL provides an 
interface between 
the Win32 API 
and OpenGL 


texture, again offsetting the array indices 
as in the PCX code. 

Now the texture contained within un¬ 
Scaled can be rescaled to have dimen¬ 
sions that are powers of two. To prevent 
the texture from losing much quality 
while keeping the performance at a rea¬ 
sonable level, a power of two that is clos¬ 
est to the original dimension will be used. 
For example, if the original width is 
greater than 256 pixels, the new dimen¬ 
sion should be 512 pixels. If the original 
width is 128 or greater (but less than 256), 


the rescaled dimension should be 256. 
After a series of if statements have de¬ 
termined a good fit for the new dimen¬ 
sions, a call to gluScalelmageO rescales 
the texture (Listing Ten). 

Finally, the glTexture array can be 
passed to OpenGL as follows: glTexIm- 
age2D(GL_ TEXTURE_2D, 0,4, scaled- 
Width, scaledHeight, 0, GL_RGBA, GLJJN- 
SIGNED_BYTE, glTexture);. Table 1 
provides a quick explanation of the pa¬ 
rameters. 

Creating an OpenGL 
Rendering Context 

WGL provides an interface between the 
Win32 API and OpenGL. It sets up a 
palette for your rendering window and 
handles such things as double buffering. 
To do this, you usually need to use four 
or five of the fewer than 20 WGL func¬ 
tions. I have written a basic C++ wrap¬ 
per class for the functions that is easy to 
use. Most of the code in the COpenG- 
LWindow class is taken from Silicon 
Graphics’ OpenGL Developer Tools CD- 
ROM for Windows 95/NT, which inter¬ 
estingly has become a collector’s item 
since SGI’s “Fahrenheit” deal with Mi¬ 
crosoft. (SGI is cooperating with Mi¬ 
crosoft on the next generation of Open¬ 
GL. Since the agreement, SGI’s, OpenGL 
drivers for Windows 95/NT have disap¬ 
peared from the SGI web site, and the 
SGI OpenGL Developer CD-ROM for 
Windows 95/NT is hard to come by. 
However, there are several web sites mir¬ 
roring its contents, including http://jawed 
.ncsa.uiuc.edu/.) 

The dimensions of the rendering win¬ 
dow are passed to the constructor, but its 
window handle must be passed to the 
OpenGLWindow::Create() class member 
function to actually create the rendering 
context. 

WGL does not physically create a win¬ 
dow for you; that is Win32’s responsi¬ 
bility. WGL creates an OpenGL render¬ 
ing context for a window that has 
already been created. If you want a win¬ 
dow to create and destroy its OpenGL 
rendering context as the window is cre¬ 
ated and destroyed, simply catch the 
WM_CREATE and WM_DESTROY mes¬ 
sages in the window’s window procedure. 
Then call OpenGLWindow::Create() and 
OpenGLWindow::Destroy(), respective¬ 
ly, as has been done in inter, c’s Graph - 
icsProc function (available electronical¬ 
ly). The only other time you really need 
to use WGL is for a system palette 
change. Windows will indicate that such 
a change has been made by sending a 
WM_PALETTECHANGED message to ev¬ 
ery window, and then OpenGLWin¬ 
dow: :RedoPalette() will take care of the 
change. 


Version 

Hle {00DD □□□□ □□□□ 

Header | 0 123 4 567 8 9 10 11 
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Data 1 - 1 1 - 1 

l 128 129 


f 12 

Palette I - 

□ 


□ . 

. □ 

Data 1 Max 

Max 

Max 

Max 

Max 

^ Length 

Length 

Length 

Length 

Length 

767 

766 

765 

764 

0 


Figure 4: The PCX format. 
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Code 

Definition 

GL_TEXTU RE„2D 

Defines a two-dimensional texture. 

0 

Supplies one texture as multiple resolutions. 

4 

indicates which of the R, G, B, and A values are used. 

scaledWidth 

New width. 

scaledHeight 

New height. 

0 

Width of the border (no border). 

GL_RGBA 

Format of the texture data. 

GLJJNSIGNEDBYTE 

Data type of the texture data. 

glTexture 

Pointer to array containing texture to be rescaled. 


Table 1: Explanation of the parameters in glTexImage2D(GLJTEXTURE_2D,0, 
4,scaledWidth, scaledHeight, 0,GL_RGBA,GL_UNSIGNED_BYTE, glTexture);. 


Drawing the Entire Model 

Inter.cpp’s redrawO function (available 
electronically) redraws the entire model 
in its current state by specifying all of the 
triangle vertex coordinates and texture 
mapping coordinates between glBe- 
gin(GL_TRIANGLES) and glEnd(). This re¬ 
quires three calls to glTexCoord2f() (two 
parameters) and glVertex3f() (three pa¬ 
rameters) for every triangle. One thing to 
note about the glTextCoord2f() function 
is that OpenGL expects texture-mapping 
coordinates to be relative, not absolute. 
To obtain these coordinate values, divide 
the original texture mapping coordinates 
from the model by their maximum range 
in the texture. In other words, divide the 
S component by the texture map’s width 
and divide Tby the texture map’s height. 
These values will fall between 0 and 1 
and remain unchanged when the texture 
is resized. For instance, (0.5, 0.5) will al¬ 
ways point to the center pixel of the tex¬ 
ture, no matter whether the texture di¬ 
mensions are 173x233 or 256x256. Of 
course, doing a floating-point divide three 
times per loop is inefficient. By storing 
these values ahead of time the loop’s ef¬ 
ficiency could be improved greatly. 

Between frame redraws the rendering 
window’s window procedure keeps track 
of mouse movements and mouse button 


activity by listening to WM_MOUSEMOVE, 
and WM_*BUTTON(UP/DOWN) mes¬ 
sages. The movement increments are then 
temporarily stored in two arrays—one 
for translational movements, and another 
one for rotations. At the beginning of each 
frame redraw the linear transformations 
are carried out using glTranslate( ) and 
glRotate(). 

Conclusion 

Although OpenGL is straightforward to 
use, simply knowing the API is not suffi¬ 
cient. Since OpenGL does not provide 
functions to read 3D model and texture 
files of your preferred format, a basic un¬ 


derstanding of 3D concepts and some 
amount of manual data manipulation is 
also required. Combining Win32 with 
OpenGL makes it possible to develop ap¬ 
plications with user-friendly interfaces and 
impressive 3D graphics. 

Keep in mind that one of OpenGL’s 
bonuses is portability. Porting your Win32 
OpenGL applications to X under UNIX 
should not be much more difficult than 
cutting and pasting some of the graphics 
code. Of course, creating another inter¬ 
face from scratch will be necessary. 

DDJ 

(Listings begin on page 96.) 
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The Kernel 
Graphics Interface 


A portable 
high-performance 
graphics subsystem 

Andreas Beck 

D etermining how an operating system 
should handle graphics is an exer¬ 
cise in tradeoffs. If you are interest¬ 
ed in the fastest possible graphics 
performance, the only solution is for your 
application to work directly with the 
graphics hardware without regard to se¬ 
curity. However, if you are willing to sac¬ 
rifice a little bit of speed to gain portabil¬ 
ity and a degree of safety, GGI could help 
you a lot. 

The GGI (General Graphics Interface) 
project (http://www.ggi-project.org/) is 
intended to bring safe, fast, and portable 
graphics to a variety of platforms and 
operating systems. GGI consists of user- 
level libraries of basic graphics functions 
and kernel-level drivers that handle the 
low-level graphics routines. The Kernel 
Graphics Interface (KGI) is the kernel con¬ 
sole interface upon which the Linux im¬ 
plementation of GGI is based. Figure 1 
shows how GGI and KGI are related. In 
this article, I describe the motivation, ar¬ 
chitecture, and implementation of KGI. 

GGI is not confined to Linux, nor to 
KGI as the display subsystem. LibGGI is 
a lightweight graphics library that runs on 
a variety of platforms and graphics sub¬ 
systems like X-Windows (tested on Solaris, 
AIX, IRIX, Linux, and others), SVGAlib 


Andreas studies physics at the University 
of Dusseldorf Germany. He can be 
reached at andreas.beck@ggi-project.org. 


(Linux), or other native graphics interfaces 
like the Sun framebuffer device. Ports for 
more targets (such as Microsoft Windows) 
are in the works. 

The Problem 

The job of an operating system is to ar¬ 
bitrate access to hardware to preserve the 
stability of the system, prevent software 
from damaging the hardware, and pro¬ 
vide the software with an abstracted view 
of the hardware. 


Few operating systems do this proper¬ 
ly for graphics cards. Graphics support is 



either placed entirely in the kernel (like 
NT) or is left to user-mode applications 
with special permissions (like traditional 
Linux SVGAlib or X applications). 

From a security point of view, there is 
nothing wrong with placing all graphics 
functionality in the kernel. The problem 
is that it vastly increases the kernel size 
at the expense of stability. Video drivers 
become more difficult to write and espe¬ 
cially to debug— and errors in the drivers 
impact system stability. 

On the other hand, the SUID root ap¬ 
proach used by X and SVGAlib presents 


some security hazards. In general, you 
want to avoid running any applications as 
SUID root, since buggy or malicious code 
can easily be manipulated to break into, 
or simply break, a system. 

A malicious, or merely carelessly pro¬ 
grammed, graphics application can eas¬ 
ily hang the system by causing a bus 
lockup (possible with many graphics 
cards due to bad programming), leaving 
the console in graphics mode (making 
it hard to use the system), or locking out 
virtual console switching. Worst of all, a 
malicious application might even be ca¬ 
pable of damaging hardware by pro¬ 
gramming unsuitable clocks, thus over¬ 
loading the RAMDAC and/or monitor. 
While most modern monitors have pro¬ 
tection circuitry for this, RAMDACs are 
usually without defense. 

X circumvents this problem somewhat 
by being a client-server system, which pro¬ 
tects the privileged server from malicious 
or buggy user code. Yet even then, it is 
still possible to abuse the X server, for in¬ 
stance, to read any file on your system 
(see http://www.rootshell.com/). 

SVGAlib is a bigger problem, because 
its applications must be SUID root. Con¬ 
sider the binary-only releases that are nec¬ 
essary for commercial games but must run 
SUID root. Would you trust all vendors 
not to spy on your system? Would you al¬ 
ways check PGP signatures to make sure 
you don’t have a hacked copy with some 
Trojan Horse? Even worse, normal users 
can’t develop SVGAlib applications since 
root access is necessary to give appropri¬ 
ate permissions to the executable so it can 
be tested. 

The Solution 

KGI tries to address these problems by 
moving only the critical part—the actual 
programming of the graphics hardware— 
to the kernel. This reduces the security 
problems to those that any UNIX device 
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(continued from page 50) 
exposes: inappropriate file system per¬ 
missions and bugs in the driver. 

KGI does not do the actual drawing in 
the kernel. It’s not necessary, and doing 
so would increase the possibility of errors 
that are even more serious when they hap¬ 
pen in a kernel context. The KGI driver 
is designed to be a thin layer around the 
hardware functionality. It only abstracts 
functions that are fairly standard between 
different cards. 

Functions for setting up modes and 
some common accelerated drawing func¬ 
tions are available via a standard com¬ 
mand API, while card-specific quirks are 
exported in a private command area that 
is called by a card-specific user-mode 
counterpart. 

Implementation Considerations 

Speed is the main problem with a graph¬ 
ics interface that is at least partially run¬ 
ning in kernel mode. If you needed to 
make a kernel mode call every time you 
called a basic function like drawing a pix¬ 
el, the system would crawl. 

Fortunately, almost all available cards 
have some notion of a framebuffer, a por¬ 
tion of the onboard Video RAM (VRAM) 
mapped into the CPU’s address space. Ac¬ 
cessing the VRAM is normally considered 
a safe operation. Some hardware acceler¬ 
ator registers are mapped to VRAM, but 
these can normally be excluded by the 
kernel code via the MMU of the host CPU. 

From user-mode, the KGI driver API 
exposes a command interface that needs 
to do a user-to-kernel transition (under 
Linux, an ioctl call to /dev/graphic), and 
a memory-mapped linear framebuffer, a 
continuous area in RAM that represents 
the VRAM contents. 

Not every graphics card has a linear 
framebuffer. However, as those of you 
who are familiar with DJGPP may know, 
there is an elegant solution for this: the 
MMU. If the card exports a banked-style 
buffer (for example, a 64K window at 


OxAOOOO, as old Trident 8900s did), it is 
mapped at the appropriate place in a vir¬ 
tual memory area as big as a linear buffer 
of the card would be. The other areas are 
marked to be swapped out. If such an 
area gets hit, the driver is notified, moves 
the card’s window accordingly, and cor¬ 
rects the mapping. 

There are some speed problems with 
this, because the MMU trap is expensive 
compared to just setting the bank with an 
“out” instruction. At the same time, due 
to the design of most such cards, we can¬ 
not export the banking register to user 
space anyway, because of security con¬ 
siderations (it is normally on an indirect 
register that also hosts CRTC timing, and 
so on). On the other hand, this approach 
leaves bank-crossing-detection to the 
MMU and thus saves unnecessary (some¬ 
times nontrivial) checking code. 

Now, we have a decent and fairly fast 
interface for all common tasks. All really 
primitive things that are not worth the 
overhead to call into the kernel (Draw- 
Pixel, very short lines, and so on) are per¬ 
formed via the MMAPed VRAM. More 
complex and administrative functions are 
performed via the command interface. 

One other catch is that you probably 
do not want to write any emulation code 
into the drivers for cards that do not have 
a particular function accelerated. Micro¬ 
soft’s DirectX handles this problem using 
capability bitmaps. Having capability 
bitmaps means that you can query to see 
if an acceleration function is available via 
some kind of a bitmap or test for a NULL 
pointer. In our opinion, this is too hard 
to extend, because you have to extend the 
bitmap or table with every new version, 
making lots of revision checks necessary 
to see if a particular capability is accessi¬ 
ble in a given revision at all. So we chose 
another way to handle software fallback 
for our acceleration code. 

An accelerated function call always re¬ 
turns a status code that either says “com¬ 
pleted successfully” or an error code that 


suggests what to do instead and also how 
long that information is valid. 

The suggestion can say: 

• CANNOT: This is returned for hardware- 
specific operations or context-sensitive 
operations (for instance, trying to set 
the frame for video overlay on a board 
without such capability). 

• USE_LOWER: This is used when it is 
most likely a good idea to use a set of 
simpler acceleration calls (for example, 
using multiple horizontal lines to draw 
a box), because the resulting calls would 
be accelerated. 

• USE_MMAP: This is returned when no 
simpler accelerator calls are supported. 
Thus, it is advisable not even to try them, 
but rather to directly draw on the 
MMAPed VRAM. 

The expire information tells how long 
this information is valid. This allows us 
to avoid having to call the accelerator 
function each time for cases where a cer¬ 
tain accelerator function may be only 
temporarily unavailable. 

• NOW: Retry next time. It can’t be done 
just now, because the accelerator is too 
busy or some similar problem that is 
likely to go away the next time the func¬ 
tion is called. 

• GC: Retry when the graphics context 
has changed (for example, if the accel¬ 
erator cannot draw with a given raster 
operation). 

• MODE: Retry when the mode has 
changed (that is, if the accelerator can¬ 
not be enabled in a specific mode as in 
the VGA compatibility modes of many 
common accelerators). 

• ALWAYS: The accelerator never has this 
capability. 

The advantage of handling software 
fallback this way over a DirectX-style 
bitfield is that this is extensible in a 
compatible way on both kernel and user 
sides. A newer KGI driver will know 
some new command codes that older li¬ 
braries won’t know about. So, you could 
lose a bit of extra acceleration with old¬ 
er libraries, but it’s better than being in¬ 
compatible. 

A newer library may use some com¬ 
mand codes that are not supported by old¬ 
er drivers. This triggers a “default” case 
that deals with the commands and always 
returns ENOSUP_ALWAYS_LOWER or 
ENOSUP_ALWAYS_MMAP (depending on 
whether or not the driver has a reason¬ 
able base set of accelerated commands). 
This return code causes the library to per¬ 
manently disable the accelerator call after 
the first try and use an emulation routine 
instead. Again, you may lose a bit of po¬ 
tential acceleration if your kernel isn’t up 
to date with the library, but it still works. 



Figure 1: How GGI and KGI are related. 
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(continued from page 52) 

Enhancements 

While the scheme described earlier is 
enough for normal applications, there 
have always been some drawbacks to this 
approach: 

• Only relatively common acceleration 
commands are supported. Adding all 
the card specifics would result in an in¬ 
credible number of commands. In ad¬ 
dition to the number of commands in¬ 
creasing astronomically, it is very 
possible that different accelerator func¬ 
tions in two different drivers could end 
up using the same command codes, as 
drivers are developed independently. 

• There is no direct way to get at the ac¬ 
celeration registers, even if this is oth¬ 
erwise safe to do (which it is for a few 
very high-end cards). 

• Some cards have multiple memory ar¬ 
eas for textures, overlays, and so on. 

The EvStack 
Kernel 

Enhancement 

■■ vStack is an extremely flexible con- 
P sole system we designed to over¬ 
ly come some limitations of the cur¬ 
rent Linux-KGI kernel patch, which 
breaks some features and programs 
(notably XFree and SVGAlib). The ba¬ 
sic idea behind EvStack is to pass 
events between independent modules 
instead of hardwiring the calls. This al¬ 
lows you to plug together a console 
and dynamically swap out parts, like 
the VT-emulation. Under EvStack, you 
can have xterm, Linux, and dumb con¬ 
soles on the same machine as well as 
different fonts, screen sizes, and screen 
modes (for instance, graphical con¬ 
soles) on the different virtual termi¬ 
nals. With the EvStack patch installed, 
you can do one of three things: 

• Turn EvStack off at compile time, giv¬ 
ing you traditional Linux console code. 

• Turn EvStack on, but load or com¬ 
pile in the conlinux.o module, giv¬ 
ing you traditional Linux behavior 
running on the new code. 

• Turn EvStack on, but don’t load 
conlinux.o, giving you pure EvStack 
behavior, with the additional con- 
linux API disabled and all configu¬ 
ration occurring via /proc. 

—A.B. 


• There is no way to support display lists 
or similar things that would dramatical¬ 
ly reduce the number of user-to-kernel 
transitions and, thus, overhead. 

To overcome these limitations, KGI al¬ 
lows exporting additional API functions that 
allow you to circumvent these problems: 

• Private commands. KGI reserves an area 
for private command codes. These are 
handled by a card-specific library in user 
space to make the best possible use of 
the card. 

• Mapping of card Memory-Mapped IO 
(MMIO) areas, or eventually allowing 
access to the card’s ports if this is safe 
(up to now, we have not found cards 
where port access is safe). Here, too, 
card-specific libraries are used to con¬ 
vert the card-specific API represented 
by the MMIO area to the common API. 

• Mapping of cards’ additional memory 
areas like texture memory, YUV over¬ 
lay planes, and so on. 

• PingPong buffers, which are simply filled 
with commands (all in user space) and 
then executed with a single command 
(one user-to-kernel transition). This op¬ 
eration can be done asynchronously 
with the program continuing to execute 
on the host CPU, while the accelerator 
is fed with commands using either 
DMA, accelerator-generated “accel-idle” 
or “accel-buffer-lowwater” interrupts, or 
host-generated timer interrupts. This al¬ 
lows for maximum throughput, as the 
host CPU can prepare the next drawing 
commands while the accelerator is still 
drawing the last batch. 

Multiple APIs and Libraries 

I have talked about having multiple APIs. 
How do you know which particular APIs 
are present and how to make use of them? 
How do you avoid a horrible mess where 
the applications must know all of the APIs? 

This is one of the reasons for LibGGI, 
which consists of a basic stub library and 
a rather large bunch of API libraries that 
build the bridge between the various hard¬ 
ware (or software—LibGGI can also be 
used to display in an X-Window) APIs and 
the LibGGI API. When setting up a mode, 
LibGGI asks the target (KGI in our case) 
for a list of the exported APIs, a set of 
strings that classify how you can access 
various card features. Figure 2 shows a 
typical API list. The meanings of the 


"generic-linear-8" 
"generic-ioctl" 
"generic-ramdac" 
"S3~generic" 
"S3-virge" 


Figure 2: Typical API list. 


strings, which are listed in increasing or¬ 
der of precedence; see Table 1. 

The libraries are loaded in a way that 
allows more specific functions to overload 
the more generic ones, automatically yield¬ 
ing a startup configuration that always 
uses the best available function. In some 
cases (as with the ioctl API), these entries 
can be altered at run time if functions are 
not available. 

One problem remains. LibGGI can only 
make use of functions that are needed for 
implementing the LibGGI API. If you look 
at these functions, you will realize that 
they account for few of the functions a 
card can support. 

We have decided to keep LibGGI small 
to save space for simple applications and 
things like embedded systems. For more 
complex functions, LibGGI allows the reg¬ 
istration of extensions like LibGGI2d and 
Mesa-GGI, which add support for the APIs 
necessary for specific tasks. 

Implementation Details 

Additional goals with the design of KGI 
included: 

• Easy driver writing. 

• Modular design for cards that are made 
from similar components (S3 cards with 
different RAMDACs, clocks, and so on 
are a good example). 

• A simple way to enhance drivers for fair¬ 
ly compatible future generations of 
known cards. 

• Full abstraction from the operating sys¬ 
tem for easy portability. 

These are achieved by using a modular 
design approach that makes every KGI 
driver consist of six basic modules: 

• Chipset module. This controls all func¬ 
tions related to mode setup, CRTC pro¬ 
gramming, RAM timing characteristics, in¬ 
terfacing RAMDAC and Clock, and so on. 

• Clock module. This controls the pixel 
clock generation. This is separated from 
the chipset driver, as there are cards 
(S3, for instance) that have the clock as 
a physically distinct chip, with the dif¬ 
ferent cards made by combining basic 
chipset, clock, and RAMDAC chip in 
different ways. 

• RAMDAC module. The RAMDAC mod¬ 
ules is similar to the clock module, but 
controls the RAMDAC features like 
palette setting, VRAM-bus activation, 
RAMDAC-internal hardware cursors, 
Gamma correction, and the like. 

• Graphics (accelerator) module. Some 
chips have the acceleration engine ei¬ 
ther detached from main chipset or use 
the same or very similar acceleration en¬ 
gine on different chipset versions. Thus, 
separating acceleration programming 
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from the other aspects of the card makes 
sense (that is, all newer S3 cards can be 
run with the S3 generic acceleration driv¬ 
er). Not all of the capabilities of very 
new cards would be used, but driver 
development is eased quite a bit, since 
you can try out your new chipset driv¬ 
er without having to write a graphic 
module. 

• Monitor module. What features are there 
in a monitor that will need a driver? At 
the very least, such things as timing lim¬ 
itations, ensuring that the image is cen¬ 
tered on the screen, power-saving ca¬ 
pabilities, and more. Being able to use 
any of these requires some knowledge 
about what the monitor supports. The 
monitor driver allows safe access to 
these features, and automatically choos¬ 
es suitable timings. 

• Kernel module. This does the interfac¬ 
ing to the host OS. It implements access 
methods to the hardware, to PCI ser¬ 
vices, and so on. In theory, we should 
be able to run the same KGI driver on 
different operating systems by just link¬ 
ing with a different kernel module. (We 
have not yet tried this because we are 
currently restructuring the Linux con¬ 
sole. Porting efforts now would result 
in a lot of duplicate work.) 

Conclusion 

What does Linux gain by using KGI? First, 
the graphics card is handled like any oth¬ 
er device, which means that arbitration 
and access to critical registers occur in one 
central place—the kernel. 

Second, since the kernel is able to con¬ 
trol the graphics card, we have a few new 
capabilities: 

• A real Secure Attention Key (SAK) that 
can kill off graphical applications safe¬ 
ly because the kernel itself is able to re¬ 
set the graphics card to a sane state. 

• Simple and safe resizing capabilities for 
VTs. For example, with KGI, you can 
implement VT100 ESC codes that were 
impossible to implement without these 
resizing capabilities. 

• Support for graphical consoles, thanks 
to the new EvStack kernel enhancement 
(see the accompanying text box entitled 
“The EvStack Kernel Enhancement”). 
This is immensely desirable for hard¬ 
ware that has no VGA-like text mode 
or for languages that require the ability 
to represent more than 236 characters. 

• The ability to operate the graphics card 
in MMIO mode, which means that the 
registers of the card are mapped to a 
programmable place somewhere in the 
memory address space, thereby freeing 
the VGA registers in IO space. As a re¬ 
sult, Linux/KGI is multihead capable 
with cards that support that feature. 


String 

Meaning 

S3-virge 

This is an S3 Virge 
card. If you have a 
specific library that 
knows the AH and 
the Virge-specific 
functions, then load it. 

S3-generic 

The kernel knows 
which functions are 
available on all S3 
cards. 

generic-ramdac, 

generic-ioctl 

The generic RAMDAC 
APIs are supported, 
as is the KGI-ioctl 
interface. 

generic-linear-8 

The card (for this 
mode, anyway) has 
a linear framebuffer 
with eight bits per 
pixel. 


Table 1: The meaning of the strings in 
Figure 2 (from bottom to top). 


Third, together with LibGGI, you have a 
lightweight, portable, and fast graphics sub¬ 
system. (A single-disk demo that uses a 
mere 700-KB compressed image is available 
electronically; see “Resource Center,” page 
3, or my home page at http://sunserverl 
.rz.uni-duesseldorf.de/~becka/.) This is of 
special interest for embedded systems, 
which can now use Linux instead of rela¬ 
tively expensive and less open (“nice 
README, but where is the source?”) solu¬ 
tions like QNX or Windows CE. 

Finally, you will no longer have danger¬ 
ous SUID root graphics applications. The 
GGI project has developed both a wrapper 
library that allows most SVGAlib applica¬ 
tions to run without root permissions, and 
a replacement X server called Xggi. 

Resources 

The GGI homepage (http://www.ggi-pro- 
ject.org/) contains snapshots of the latest 
source, instructions on how to obtain them 
via CVS, links to GGI-relevant web sites, 
and up-to-date information about the pro¬ 
ject. Our mailing list is hosted at ggi- de¬ 
velop® eskimo.com. Subscription infor¬ 
mation is found on the GGI web site. If 
you plan on subscribing, be prepared— 
the list has high traffic. 
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TURN YOUR PC INTO A UNIX SERVER 
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supports 2500 concurrent users. Try that on WinNT! 

FreeBSD is ideal for multi-OS environments. It comes with 
a boot manager for easy switching between OSes. Using 
Samba and Netatalk, it allows Win95, Macintosh and Unix 
to seamlessly share the same files with no additional 
software needed on the clients. 


FreeBSD is used by many of the world’s largest 
organizations for high-performance Internet servers, but it 
is also used by millions of individuals for their desktop 
computers and laptops. FreeBSD will run on almost any PC 
and the simple CDROM installation makes it a breeze to get 
started. 



This four CDROM set contains 
the complete OS and 2.5GB of 
applications. 
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The Complete FreeBSD is a 1725 
page book that covers every detail 
of installing and running 
FreeBSD. It includes the four 
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All products are unconditionally 
guaranteed. All proceeds are used 
to support the FreeBSD project. 
Order through our website, or 
give us a call today! 


Walnut Creek CDROM 

4041 Pike Lane Ste F-398, Concord, CA 94520 
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home page sneak preview! Doug Block's social/cultural phenomenon comes to Web 98 for a 
sneak preview - world premiere will be on Cinemax later this summer. A lucky few will win tickets 
- don't miss it! 

World-class full-day Tutorials covering everything from Ecommerce (2 days in-depth) to Perl 
and Javascript. 

Mindbending Open Sessions and Showcases: Jakob Nielsen on Web 2003, Flash and Guicktime 
in all their splendor, and much more! 

Join the WebScene at www.mfweb.com! It's a distributed, user-run community, built around 
sharing web links and talking about them in a common forum. Discuss the conference topics and 
get the buzz going long before the conference even starts! 

191 -joIs Awards hosted by Web Techniques and Web Review. 


Brian Behlendorf - Backend 
Emily Davidow - Strategy/Visual Design 
Abbe Don - Information Design 
Dale Dougherty - Strategy 
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Douglas Meisner - Visual Design 
Peter Merholtz - Information Design 
John Maeda - Visual Design 
Drue Miller - Information Design 
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From the fundamentals of site usability, to new media business models, to cutting-edge 
programming techniques, Web Design & Development '98 sets the standard for giving 
web professionals what they need to succeed. 

Web '98 provides practical training from the leading experts in Strategy, 
Information Design, Visual Design, Programming, Usability, and Backend. Join us 
for the most intense gathering of web brilliance the West Coast has ever seen. 


Cool Site in a Day - The frenzy returns. East meets West in competition to generate a website 
for a selected charity, spec unseen. A distinguished panel of judges picks the winner at a recep¬ 
tion that evening. It’s an amazing display of virtuosity. 

Visual Authoring Tools Shootout - Emily Davidow returns to host a duel between the top four 
experts on the top four web authoring environments: Macromedia's Dreamweaver, GoLive's 
CyberStudio, Elemental's Drumbeat, and last year's winner, NetObjects' Fusion. 

Career Development - If Web '98 inspires you to consider new "day job paradigms," you can 
head over to Career Development '98 where you can explore new career opportunities within 
the wired world. 

Team Discount! Buy three full price conference packages and the fourth attends FREE! 


Jakob Nielsen - Strategy 
Nadja Ochs - Information Design 
Marc Rettig - Information Design 
Howard Rheingold - Information Design 
Jared Spool - Usability 
Lincoln Stein - Programming 
Gong Szeto - Visual Design 
Jeff Veen - Usability 
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Lynda Weinman - Visual Design 
Andrew Zolli - Strategy 
AND MANY MORE! 
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www.mfweb.com 

Feeling nostalgic? Contact us by phone at 800-441-8826 or by e-mail at web98@mfi.com. 



WEB 

design&development 

where web professionals converge 



















Affine Texture 
Mapping 


A fundamental 
technique for 
graphics programmers 

Andre LaMothe 

I t used to be you could get away with 
developing flat shaded 3D computer 
games and engines. But if your soft¬ 
ware doesn’t support texture mapping 
these days, it will likely end up in the bar¬ 
gain bin. One form of texture mapping is 
“affine” texture mapping, which is funda¬ 
mental to many forms of 3D rendering, 
including light interpolation and other sam¬ 
pling type operations. In this article, I’ll 
present an affine texture mapper that can 
texture map a 64x64-pixel/236- color rect¬ 
angular bitmap onto a triangular polygon 
with full texture coordinate support. In 
addition, I’ll include a demo that loads 
texture maps and draws thousands of tex¬ 
tured triangles a second. Although this 
demo is in DirectX, the ideas and con¬ 
cepts are applicable to other systems. And 
since the texture mapper is in straight C, 
it’s totally portable. 

Getting Down to Specifics 

Assume you want to texture map a rect¬ 
angular bitmap that is 64x64 pixels in 236 
colors (one byte per pixel) onto an arbi¬ 
trary triangle with any coordinates. To do 


Andre is the author o/'Tricks of the Game 
Programming Gums, Teach Yourself Game 
Programming in 21 Days, The Black Art 
of 3D Game Programming, and his latest 
creation, Windows Game Programming 
for Dummies. He can be contacted at 
necron@slip.net or at http://xgames3d.com. 


so, you need to take rotation and scaling 
of the triangle into consideration. To de¬ 
sign the algorithm that makes this possi¬ 
ble, I’ve labeled a number of points of in¬ 
terest on Figure 1. First, the destination 
triangle is made up of three vertices— pO, 
pi, and p2, with coordinates ( xO,yO ), 
( xl,yl ), and (x2,y2\ respectively. In ad¬ 
dition, the axes around the texture map 
are U and V, where U is the horizontal 



axis and V is the vertical axis. Both U and 
V range from (0,0) in the upper left to 
(63,63) in the lower right. What you want 
to do is design an algorithm that samples 
the texture map, so that the sampled pix¬ 
els can be used to color each pixel of each 
scanline of the target triangle polygon as 
it is being rendered. 

There are a number of ways to draw tri¬ 
angles, including tracing the edges of the 
triangle with a line-drawing algorithm (such 
as Bresenham’s) or with simple interpola¬ 
tion. I prefer interpolation since it’s more 
straightforward. Also, the concept of in¬ 
terpolation is important because the tex¬ 
ture mapping algorithm is based on it. In 
Figure 2, all you have to do is find the 


points (shown as little dots) that make up 
the integer rasterized version of the trian¬ 
gle. Once you find these dots for each scan¬ 
line that makes up the triangle, drawing 
the triangle is nothing more than per¬ 
forming a memory fill from dot to dot. Find¬ 
ing these points simply involves interpo¬ 
lating the slope of each side of the triangle. 
The interpolation is done as follows: 

You know that the height of the trian¬ 
gle is: 

dy=(y2-y0); 

and the difference in the “x” between 
the lower-left vertex and the lower-right 
vertex is: 

dx_left_side=(x2-x0); 

dx_right_side=(xl-x0); 

Thus, the slope of the left side is: 

slope_left_side=dy/dx_left_si.de 
—(y2-y0)/(x2-x0 ); 

And, the slope of the right side is: 

slope_right_side=dy/dx_right_ 
side=(y2-y0)/(xl-x0); 

However, you don’t exactly want the 
slope. The slope is the “change in Y per 
change in X.” This means that if you 
were to move over exactly one pixel in 
the X direction, then the Y would 
change by the slope. You don’t want 
this. In fact, you want the opposite — 
dx/dy —because you are drawing the 
triangle scan line by scan line and in¬ 
crementing Y each time; hence dy=l, 
which is a constant. Thus: 

dx_left_side=l* (x2-x0)/ (y2-y0) ; 
and 

dx_right_side=l*(xl-x0)/ (y2-y0) ; 

Listing One (listings begin on page 96) is 
a pseudocode implementation of the 
triangle drawing algorithm. 
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Other database engines require 
design or performance concessions 
when developing applications with 
complex data relationships. With 
the patented TITANIUM® multi¬ 
model database engine, you have 
the freedom to choose the database 
models which suit your needs, and 
enjoy unrivaled performance too. 

TITANIUM is the only database 
to allow applications simultaneous 
access to the database using any 
of the relational, object-oriented 
(through C++ Object Classes), and 
navigational data models. 
Developers, for example, may use 
the ODMG-standard object model 
to manipulate complex objects and 
relationships, while users and SQL 
developers view and manipulate 
the same data as relational tables. 
Further, each model is pure, 
avoiding the weaknesses of hybrid 
models such as object-relational. 

TITANIUM’S underlying Dynamic 
Pointer Array (DPA) technology 
delivers split-second query 
responses and unrivaled 
performance. TITANIUM directly 
supports complex real-world 
relationships, eliminating the 
cumbersome intersect tables and 
redundancy associated with typical 
databases. 

TITANIUM features optimized 
read/write SQL, BLOBs, nested 
transactions, as well as compiled 
triggers and stored procedures. It 
runs in a megabyte of memory on 
all PC platforms, with support for 
a terabyte or more of data. 



TITANIUM DATABASE 
MULTI-MODEL 


NAVIGATIONAL MODEL 


RELATIONAL MODEL 


OBJECT-ORIENTED MODEL 


TITANIUM 

DATABASE ENGINE 

Optimal Performance for 
Complex Development Needs. 



mdbs 


Micro Data Base Systems, lac. 


For a TITANIUM Technical White Paper, call 800-445-mdbs or 765-463-7200. 
E-Mail: info@mdbs.com WWW: http://www.mdbs.com 

mdbs and TITANIUM are registered trademarks of Micro Data Base Systems, Inc. ©1998 Micro Data Base Systems, Inc. 

























Source Texture Map 64x64 Pixels 



Destination Polygon for Texture Mapping 


Figure 1: Texture mapping source-to-destination labeling. 



Figure 2: Screen pixel matrix. 


HI - Triangle 
# - Integer Pixel Edge Points. 
H * Scanline Rows After Filling. 


Screen Pixel Matrix 



PO (xO.yO.uO.vO) 



Figure 4* Graphic representation of texture-mapping algorithm. 



"If you enjoy learning using 
interactive mediCf recom¬ 
mend the Java™ programming 
series from MindQ." s§ys 
Miko Matsumura, Javla 
Evang elist, JavaSoft. 


^1° »P il i d r i Publ.s'nrq lu’dQ c 3 »ecn >-*. J trJdomaj^J u t M i J iloac/isa 1 'nnrUi \ IQPjL 1 h Jivaam 
dll lava-ba^ed traaeirarksand lottos are trademarks orjeyisfered tradenaib 6f*§yn Inc rt me United Stares 

cidotl ercodr tn* 1 A'lo' ^600 rdcJ ->a,i .-'sariiraJena^^O' eo.sie'-edF'iJdua k ift r sr ^ uil'r r 


e U n i v e rse Com p an y 


For more information call 800.646.3008 or visit www.mindq.com 






































































One Dimensional Interpolations 

Texture mapping a triangle with a rect¬ 
angular texture map involves lots of in¬ 
terpolating. Consequently, it’s easy to make 
a mistake or to write a slow algorithm. 
With this in mind, I’ll start with the sim¬ 
plest case in one dimension. Figure 3 il¬ 
lustrates the simplest texture mapper— 
the texture mapping of a single vertical 
line that’s one pixel thick and eight pix¬ 
els high. 

What you need to do is “sample” the 
texture map (in this case, a single 1x8 pix¬ 
el bitmap) and map it into the destination 
polygon, which is 1 xn pixels, where n 
can range from one to infinity. 

As a first example, assume that your 
destination polygon is 1x4 pixels. It makes 
sense that you want to sample the source 
texture every other pixel, as in Figure 3. 
Thus, if you select pixels (0,2,4,6) of the 
source texture and map them into the des¬ 
tination polygon at positions (0,1,2,3), then 
you are doing pretty good. But how did 
you arrive at (0,2,4,6)? The answer is by 
using a sampling ratio, which is nothing 
more than an interpolation factor. In gen¬ 
eral, sampling _ratio=source_h eight/desti¬ 
nation _height. Thus, the sampling ratio is 
sampling_ratio= 8/4=2. Thus, every one 
pixel you move on the destination poly¬ 
gon in the vertical axis, you must move 
two pixels on the source to keep up. 
That’s where the “two” comes from and 
hence the sampling sequence (0,2,4,6). 
Unfortunately, this means you had to 
throw away half the pixels. This is a prob¬ 
lem with sampling on an integer matrix 
without any averaging. If you were writ¬ 
ing a high-end 3D modeler (like 3D Stu¬ 
dio MAX), then you would probably av¬ 
erage the pixels you’re sampling (area 
sampling) to get a better approximation, 
but for games and real time, our technique 
will do. 

In the previous example, the source tex¬ 
ture was compressed; that is, the desti¬ 
nation was smaller than the source and 
information was lost. On the other hand, 
there could be the case that the destina¬ 
tion is bigger than the source, and there 
isn’t enough information to go around. In 
this case, the source data must be sam¬ 
pled more than once and replicated. This 
is where all “chunkiness” comes from 
when texture mapped polygons get too 
close to you in a 3D game. There isn’t 
enough texture data so some sample 
points are sampled many times, creating 
big blocks. Referring again to the second 
example in Figure 3, you see that the 
source is again 1x8, but this time the des¬ 
tination is 1x14 pixels. Obviously, you 
need a fractional sampling ratio. Again, 
sampling _ratio=source_h eight/destina- 
tion_height;. Thus, the sampling ratio is 
sampling _ratio= 8/14= 0.57. 


Hence, the sample for every pixel you 
draw on the destination polygon should 
be taken 0.57 units from the last sample 
point on the source. This gives you the 
following sample point sequence for des¬ 
tination pixels (0,1,2,3,.... 13): 


Sample 0: 0.57 
Sample 1: 1.14 
Sample 2: 1.71 
Sample 3: 2.28 
Sample 4: 2.85 
Sample 5: 3.42 
Sample 6: 3-99 
Sample 7: 4.56 
Sample 8: 5.13 
Sample 9: 5.7 
Sample 10: 6.27 
Sample 11: 6.84 


Sample 12: 7.41 
Sample 13: 7.98 

To get the actual sample points, you 
simply truncate the sample points in in¬ 
teger space or take the floor of each val¬ 
ue resulting in the sample points 
(0,1,1,2,2,33,4,5,5,6,6,7,7), which sounds 
about right. Each point got sampled about 
two times, or 1/0.57. 

Multiple Interpolations 

When I wrote my first affine texture map¬ 
per, I thought something must be wrong 
since it seemed like I was interpolating 
everything. The truth is, there is really 
no way around all the various inter- 
polants, and in the end, the inner loop 



Choose 
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Weapon 


ATI Macro I 


Macro Languages have been described 
as “Programmer’s Duct Tape”. While we 
might choose to compare Codewright’s 
macro languages with something more elegant, 
or permanent, we have to agree. 


Programmer's Uditor 

The point is productivity. 


Whether you need tweezers to take the splinters out 
of your code, or a chainsaw to cut your Y2K 
problems down to size, Codewright has a macro 
language that can help you. In addition to all of its 
other powerful editing features, Codewright offers 
three different macro languages for all your 
specialized needs. 


For increased productivity 
right now , download the 
free trial version . 



Single user license for 
Windows / 95 / NT. 
Volume discounts and 
site licenses available. 



“ Premium Quality Software 

Premia Corporation 
9615 SWAlien Boulevard 
Beaverton, Oregon 97005 USA 
6001 Phone: +1.503.641.6000 
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Introducing 'WinDriver 7 - The C/C++ high performance toolkit for 
quickly and easily creating a Windows 95/98/NT device driver! 
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Serious Copy Protection and 
Software Licensing with No 
Hardware Key or Disk Key 


Distribute your software via Internet, 
CD or floppy with full security. 


CrypKey provides solid copy protection with a 
broad range of features to control all aspects of 
your product's operation. You can offer free, 
automatic one-time trials, turn demos into full multi¬ 
user network versions, or sell specific options by 
phone, fax or email. Sell usage by time, runs, 
features - the control is all there - easy to implement, 
and even easier to support. 

CrypKey also offers choices - integrate our SDK 
into your software, or use CrypKey Instant to 
protect your compiled exe in 5 minutes; no coding. 

Try it free from our website to see why we're 
rated #1 by professional programmers who seek 
the best combination of security, features, ease 
of use, reliability & price. 


100% Satisfaction Guaranteed! 


http://www.crypkey.com ◄ 

Kenonic Controls Ltd., Calgary, Canada Ph: 403-258-6200, Fx: 403-258-6201, email: info@crypkey.com 


for each pixel can be optimized into 
around 10 cycles/pixel on a Pentium, 
which translates to a theoretical maxi¬ 
mum of 10- to 20-million textels (tex¬ 
tured pixels) per second on a 100-MHz 
Pentium. 

The idea behind the algorithm is that 
you want to interpolate down the left and 
right edges of the triangle and draw each 
scanline strip as we go with the proper 
texture pixels. What you need to do first 
is assign full texture coordinates to the 
vertexes of the destination triangle to give 
us a frame of reference for the inter- 
polants. Thus you must assign each ver¬ 
tex a ( u,v ) texture coordinate, as in Fig¬ 
ure 4. Therefore, each vertex has a total 
of four data components—that is, it’s a 
4D value. Since the source texture map 
is 64x64 pixels, the texture coordinates 
must range from 0-63 for any vertex. This 
will map or stretch the texture map to 
each vertex. 

Figure 3(a), for example, has the tex¬ 
ture coordinates (0,0), (63,0), and (63,63) 
mapped to vertices 0,1, and 2, respec¬ 
tively. This basically copies half of the 
texture map to the destination triangle, 
which is what you would expect. In Fig¬ 
ure 5(b), you see the same texture 
mapped onto two triangles which are 
adjacent to each other forming a square. 
In this case, the texture coordinates are 
selected in such a way that half of the 
texture map is mapped to one triangle 
and the rest to the other, hence, a per¬ 
fect texture wrapping around two trian¬ 
gles. Moreover, this is how you would 
make a quadrilateral; that is, with two 
triangles. Now that you have a visual on 
the problem and know the labeling from 
Figure 4, let’s implement the algorithm 
mathematically. The variable names used 
in the following analysis are based on 
Figure 4 and the final program so that 
you can follow the program code more 
easily. 

The left edge interpolants are: 

dxdyl = (x2-x0)/(y2-y0); 

// x interpolant for left side 

dudyl = (u2-u0)/(y2-y0); 

// u interpolant for left side 


Source Texture Mac 64 x 64 Pixels i&\ 



Figure 5: Texture mapping 3- and 4- 
sidedpolygons, (a) single triangle; (b) 
two triangles making a quadrilateral. 
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dvdyl = (v2-v0)/(y2-y0); 

// v interpolant for left side 

Similarly, the right edge interpolants are: 

dxdyr = (xl-x0)/(y2-y0); 

// x interpolant for right side 
dudyr = (ul-u0)/(y2-y0); 

// u interpolant for right side 
dvdyr = (vl-v0)/(y2-y0); 

// v interpolant for right side 

There’s a lot of room for optimization. 
For example, (y2-y0) is common and 
need only be computed once. Further¬ 
more, it’s better to compute the recipro¬ 
cal of (y2-y0) and then multiply. 

The interpolants must be in reference 
to some starting point. This starting is 
the top-most vertex, vertex 0. Hence, 
you need to start the algorithm off in 
the following manner: 

xl = x0; // starting point for 
left side edge x interpolation 
ul = u0; // starting point for 
left side edge u interpolation 
vl = v0; // starting point for 
left side edge v interpolation 

And for the right side, 

xr = x0; // starting point for 
right side edge x interpolation 
ur = u0; // starting point for 
right side edge u interpolation 
vr = v0; // starting point for 
right side edge v interpolation 

Now you can interpolate down the left 
and right edges with: 

xl+=dxdyl; 
ul+=dudyl; 
vl+=dvdyl; 

and 

xr+=dxdyr; 
ur+=dudyr; 
vr+=dvdyr; 

At each point on the left and right 
edge of the triangle, you still need to 
perform one more linear interpolation 
across the scanline. This is the final in¬ 
terpolation and the one that will give 
you the texture coordinates ( ui,vi ), 
which you’ll use as [row, column] in¬ 
dexes into the texture bitmap to obtain 
the textel. All you need to do is com¬ 
pute the u,v coordinate on the left and 
right side, then use the dx to compute 
a linear interpolation factor for each. 
Here’s the math: 

dx = (xend-xstart); 

// difference or delta dx 
xstart = xl; 

// left starting point 
xend = xr; 

// right starting point 


Therefore, the interpolants across each 
scanline in u,v space are: 

du = (ul-ur)/dx; 
dv = (vl-vr)/dx; 

Then with du,dv, you have everything you 
need to interpolate across the scanline at 
vertical position y from xstart to xend, see 
Listing Two. 

Conclusion 

That’s it. Of course for the outer loop, you 
would still interpolate xl, ul, vl,xr, ur, vr down 
the triangle edges for each scanline of the 
triangle. 

The files tmapper.h and tmapper.cpp 
(available electronically; see “Resource 
Center,” page 3) provide a complete im¬ 


plementation of the texture mapper. The 
program assumes a specific input data 
structure and that the texture map is a lin¬ 
ear bitmap 64x64 pixels. Other than that, 
it’s nothing more than an implementation 
of the derivation here, along with all the 
triangle cases and clipping. In addition, 
the program tmapdemo.cpp (available 
electronically) is a complete DirectX demo 
of the texture mapper that draws ran¬ 
dom triangles all over the screen in 
640x480x236. Finally, BOX2.EXE is a 3D 
demo written by Jarrod Davis that uses 
the texture mapper. 


DDJ 

(Listings begin on page 96.) 
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Inside DVD 


More storage, more 
features, same size 

Linden deCarmo 

A lthough DVDs physically resemble 
CD-ROMs (five inches in diameter 
and 1.2 mm in thickness), DVD 
stores between seven and 25 times 
more data. This huge storage capacity 
makes it an ideal distribution vehicle for 
full-length movies (up to four hours long), 
high-quality audio (the contents of up to 
13 CDs can be stored on one dual-layer 
DVD), and similar applications (not to 
mention data storage). DVD has garnered 
support from all major electronics and 
computer companies, and many major 
movie and music studios. 

Even though DVD technology is 
promising, technical details about it are 
scarce—in part because those details are 
still being worked out. Currently, speci¬ 
fications have been agreed upon for DVD- 
Video and DVD-ROM. As its name sug¬ 
gests, DVD-Video is for video programs 
and is played in DVD players connected 
to TVs. DVD-ROM, on the other hand, 
stores computer data and is read by DVD- 
ROM drives connected to computers. Vari¬ 
ations on DVD-ROM include those that 
are recordable one time (DVD-R) or many 
times (DVD-RAM). Most computers with 
DVD-ROM drives can also play DVD- 
Videos. Finally, there’s the DVD-Audio 


Linden is a software engineer at Oak Tech¬ 
nology where he is currently working on 
the Interactive DVD Browser, the first pub¬ 
licly available DirectShow DVD environ¬ 
ment. You can contact him at lindend@ 
ibm.net. 


format, for which technical specs haven’t 
yet been finalized. 

In this article, I’ll examine how a DVD- 
Video (or simply DVD) player operates, 
examine the features of a DVD title, and 
investigate the interactive capabilities in 
both computer and consumer DVD titles. 
(Also included with this article is a bare- 
bones, command-line DVD player, which 
is available electronically; see “Resource 
Center,” page 3.) 

DVD was conceived by the DVD Fo¬ 
rum, a consortium of companies that in¬ 
cludes Hitachi, JVC, Matsushita, Mitsubishi, 
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Philips, Pioneer, Sony, Thomson, Time 
Warner, and Toshiba. Although no one 
“owns” DVD, companies making DVD 
products must license patented technolo¬ 
gy from a pool of companies. 

One result of this collaboration is the 
multivolume series DVD 1.0 Specification 
for Read-Only Disc (ordering instructions 
are available at http://www.mpeg.org/ 
MPEG/DVD/General/Order, html). The 
most interesting book in this series is Vol¬ 
ume Three , which focuses on DVD- 
Video — a combination of a reference 
player design, optical media format, and 


multimedia data structures. The DVD-Video 
specification describes the required fea¬ 
tures to which a hardware-independent 
virtual machine must adhere. It also defines 
the assembly-language opcodes that have 
to be interpreted, the state diagrams the 
player must enforce, the system registers 
that can be manipulated, and the size and 
capabilities of user-accessible memory. 

The DVD-Video Specification 

The DVD-Video virtual machine contains 
a low-level, assembly-like, instruction set 
with the usual branch, compare, and set 
operations found in most processors. 
However, the specification also has unique 
opcodes specifically designed for interac¬ 
tive presentations. For example, there are 
instructions to monitor parental controls, 
jump to specific locations in a presenta¬ 
tion, and dynamically switch audio and 
video tracks. 

All DVD players have at least 20 sys¬ 
tem parameters (or registers) that can be 
accessed only by privileged opcodes. For 
instance, there are instructions to change 
the currently playing audio stream and 
update the system register, which moni¬ 
tors the currently playing audio stream 
number. The player also offers 16 gener¬ 
al-purpose parameters that you can mod¬ 
ify without special instructions. 

Every DVD-Video disc contains a 
video Js (or video title set) directory, which 
consists of files with IFO or VOB exten¬ 
sions. VOB files store multimedia data, 
whereas IFO files instruct the player how 
to play the content in VOB files. There 
are two types of IFO files—Video Man¬ 
ager (VMG) and Video Titles Set (VTS). 

DVD Video Manager 

VMG is found in the video_ts.ifo file and 
it is the first file all DVD players read. 
This file is similar to a boot sector on a 
floppy disk— it supplies the player with 
initialization information and then points 
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(continued from page 64) 
the player to where it can obtain the re¬ 
mainder of the data necessary to contin¬ 
ue playback. 

VMG contains vital information such as 
the name of the disc, number of titles on 
the disc, and optional information such as 
parental controls (parental controls prevents 
little junior from looking at violent or ex¬ 
plicit material). Although DVD defines eight 
numerical levels of parental protection, the 
name associated with each level may dif¬ 
fer between countries (for instance, the 
Canadian rating system differs from the 
United States system). In all cases, higher 
parental level values always permit more 
content to be viewed (see the accompa¬ 
nying text box “Parental Levels”). For in¬ 


stance, Parental Level Seven (“NC-17” in 
the United States) enables you to see more 
movies than Level One (“G” in the U.S.). 

A VMG may also contain a feature 
known as the “VMG Menu” (VMGM), 
which gives users an overview of the disc’s 
contents and potentially lets users jump 
to specific points in the title. It is com¬ 
posed of a video stream and an optional 
audio stream and a subpicture stream. To 
avoid bugs in the first generation of play¬ 
ers, most early menus used MPEG-2 still 
images and had minimal interactivity. Be¬ 
cause newer players are more stable, in¬ 
novative authors are including full-motion 
video and surround sound in their menus. 

Interactive features in menus (such as 
background audio and video) are dis¬ 


played and controlled by data structures 
called “Program Chains” (PGCs)— arrays 
of programs, each of which normally rep¬ 
resents a screen within a menu or chap¬ 
ter in a movie title. Each program con¬ 
tains one or more cells. Cells let you divide 
menus or chapters into more granular or 
logical subdivisions. They last a finite pe¬ 
riod of time, may have command instruc¬ 
tion (or DVD assembly opcode) associat¬ 
ed with them, and can enforce a delay 
when they complete playback. Although 
few titles take advantage of multiple cells 
per program, the DVD specification en¬ 
ables this feature to support effects such 
as slide shows in which playback must 
pause for a specific period of time after 
displaying a cell (or image). 

Besides programs, PGCs may contain 
up to 256 navigational commands (128 of 
which may be executed before the pro¬ 
grams in the PGC are presented, and 128 
thereafter). These navigational commands 
are used for interactive purposes such as 
modifying the current video angle. 

Every PGC also contains User Opera¬ 
tions (UOPs), which are stored in 32-bit 
fields where each bit (or individual UOP) 
represents the status of a unique interac¬ 
tive function on the player. Because these 
UOPs dictate which features in a PGC are 
legal (or usable), they have been almost 
as controversial as the region codes (see 
the accompanying text box entitled “Re¬ 
gion Management”). To illustrate why this 
feature is so contentious, examine the Fast 
Forward UOP bit. If this bit is set, the DVD 
player cannot fast forward for the dura¬ 
tion of that PGC. As a result, tricky con¬ 
tent creators can embed commercials in 
DVD content and users will not be able 
to fast forward past them! 

Attached to the tail of the VMG is the 
First Play PGC (FPGC). Once the DVD 
player is initialized, it searches for this 
PGC and executes the navigational com¬ 
mands inside of it. Most titles contain 
FPGCs that cause the player to display 
the VMGM, although it is possible for the 

Item #1 
Item #2 

Item #3 
Item #4 


Figure 1: How highlights work. The 
DVD player manipulates the color 
and contrast of a rectangle within the 
subpicture and this causes the area to 
appear highlighted. Here, the contrast 
for Item #2 is emphasized so that it 
appears selected. 
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FPGC to bypass the menu and jump di¬ 
rectly into a movie scene (this is the tech¬ 
nique that movies such as The Mask use 
to initiate immediate playback of a title). 

Besides the video_ts.ifo file, the VMG 
also contains a Video OBject (VOB) file 
named video_ts.vob. VOB files are divid¬ 
ed into packs each of which may contain 
a different media stream (packs are simi¬ 
lar to a chunk in a WAV file). Although a 
pack may contain any data type, the DVD 
specification has stringent definition for 
video, audio, and subpicture packs. 

Video packs in a VOB file normally con¬ 
tain MPEG-2 video. Although the MPEG-2 
video format was defined by a standards 
body, it supports myriads of options that 


make it difficult to create a robust decoder. 
Therefore, to enhance compatibility and re¬ 
liability, DVD places the restrictions of lim¬ 
ited choice of resolution and maximum bit- 
rate guidelines on MPEG-2 video content. 

For NTSC locales (North America and 
Japan), the MPEG-2 video stream resolu¬ 
tion in DVD must be 720x480, 704x480, 
352x480, or 352x240. PAL (or European) 
resolutions must be 720x376, 704x576, 
352x576, or 352x288. Furthermore, what¬ 
ever video resolution and audio com¬ 
pression routines are used, the content 
cannot exceed a sustained bit-rate greater 
than 10.08 Mbits/sec. 

The designers of DVD also delineated 
what audio packs may appear in a DVD 
stream. The audio types supported in the 


initial DVD specification include: Pulse 
Code Modulation (PCM), Dolby Digital 
(AC-3), MPEG-2 audio, Digital Theater 
Sound (DTS), and Sony Dynamic Digital 
Sound (SDDS). PCM is commonly used in 
stereo sound tracks and is identical to PCM 
content found in Windows, UNIX, and 
Macintosh (although DVD supports high¬ 
er PCM resolutions and sampling rates 
than these environments). 

If the content contains multichannel 
sound, then for all practical purposes, it 
contains AC-3 packs. To explain, the DVD 
specification states that AC-3 is mandato¬ 
ry for multichannel audio content in North 
America. By contrast, European (or region 
two) content initially mandated that MPEG- 
2 audio be the default multichannel au¬ 
dio standard. Recently, the Region Two 
Specification was modified to require ei¬ 
ther AC-3 or MPEG-2 audio for multi¬ 
channel content. Since every other region 
in the world requires AC-3, it is likely that 
AC-3 will become the dominant format in 
Europe also. 

Besides video and audio, VOB files also 
support subpicture packs. In DVD termi¬ 
nology, a subpicture is a Run Length- 
compressed bitmap. Each bitmap has a 
palette of 16 colors, four of which can be 
active at once. Up to 32 subpicture streams 
can exist in a given VOB file (usually one 
stream per language). Unfortunately, since 
the subpicture palette is so limited, it is 
difficult to create realistic effects with sub¬ 
picture alone. As a result, many vendors 
combine subpicture with high-resolution 
MPEG-2 video. 

The most noticeable use of subpicture 
is for closed-caption text. Behind the 
scenes, DVD also uses subpicture in 
menus. When a menu is displayed, the 
DVD player modifies the color and con¬ 
trast of the subpicture for a particular area 
in the menu, the location appears to be 
highlighted or selected. As users traverse 
the menu, the subpicture rectangle is 
changed so that a selected area moves 
with them; see Figure 1. 

Unlike conventional bitmaps, subpic¬ 
ture data in the stream may be attached 
to display instructions (or opcodes) that 
manipulate the image. For instance, there 
are opcodes that cause the subpicture 
bitmap to fade or scroll. However, the 
most interesting opcode is forcedly start 
display. Users often turn off the decoding 
of a subpicture so that they don’t have to 
view foreign subtitles. When the DVD 
player encounters forcedly display op¬ 
code, the subpicture must always be de¬ 
coded regardless of user preferences (this 
is why subpictures in menus will always 
be displayed even if subpicture decoding 
is turned off). 

Woven among the subpicture, audio, 
and video are highlight packs. These 


Stuck with the editor 
that came in the box? 


With so many powerful new programming 
languages available today, it's impossible to 
overlook one flaw they all have in common: a 
built-in text editor that is woefully inadequate! 

If you want real programming power, you 
need Multi-Edit 8 as your 32-bit source code 
editor. 

Multi-Edit offers full integration with several 
popular IDEs including Borland Delphi, C++ 
Builder, and Watcom C/C++. 

• Program in multiple languages with extensive support 
for C/C++, Delphi, HTML, ASP, Java, PERL, JavaScript, 
VBScript, Pascal, Modula-2, SQL and more. 

• Integrate with most Version Control systems, including 
Check In/Out, History, Compare. VCS Integration now 
supports the 32-bit SCC API standard, for a faster, more 
streamlined interface. 

• Integrate other tools like debuggers and preprocessors. 

• Design your own editor with Easy and Extensive 
Customization, including Reconfigurable Keymapping, 
Toolbars and Menus. 

• Compare and synchronize files while editing. 

• Cut keystrokes in half with language-sensitive Smart 
Indenting, Template Editing, Construct Matching and 
Code Completion. 

• Run any compiler in the background from within 
Multi-Edit with complete error capture. 

• Search and Replace multiple files across multiple 
directories with full grep-style expressions. 

• Navigate your code faster and easier with Collapsible 
Editing, Syntax Highlighting and Multi-Tags. 

• Write powerful functions with Multi-Edit’s Built-In 
Macro Language. Includes full System Source Code. 

• Restore an unlimited number of working environments 
with the Session Manager. 

• Organize project files, tools and settings with Project 
Manager. 



Try it free at 

www.muitiedit.com 



1830 W. University Dr., Ste. 112 
Tempe, AZ 85281 USA 
(800) 899-0100 sales@multiedit.com 

Outside the US & Canada, contact 
Soft/Export, Inc. 

Voice: + 1-781 -449-1440 
Fax: +1-781-455-6526 
www. softexport. com 
info@softexport. com 
© 1998 American Cybernetics, Inc. Multi-Edit, the Multi-Edit logo, American 
Cybernetics, and the American Cybernetics logo are trademarks of American 
Cybernetics, Inc. All other trademarks are the property of their respective owners. 



68 


Dr. Dobb’sJournal, July 1998 











































highlight packs contain user interface el¬ 
ements called buttons. Buttons are rect¬ 
angular areas on the screen that monitor 
user input, and up to 36 buttons can be 
displayed at any single time. Each button 
contains associated highlight data struc¬ 
tures, and these structures inform the play¬ 
er how to color a button when it is not 
selected, when it is selected, and when it 
is chosen (or activated). It also informs 
the player how long the buttons should 
remain on the screen and which numeri¬ 
cal sequence on the player’s remote con¬ 
trol can select the button. 

DVD Video Title Manager 

Besides the VMG, every DVD Video disc 
contains one or more titles (or movies). 
These titles are stored in logical contain¬ 
ers called “Video Title Sets” (VTS). Like 
the VMG, there is a strict naming con¬ 
vention for files in a VTS. All files in a VTS 
are in the form vts_xx_y where xx is the 
VTS number (up to a maximum of 99) 
and y is the index within the VTS. 

Each VTS has a unique IFO file, 
vts_xx_y.ifo, and it uses the same data 
structures as the VMGM: PGCs, programs, 
and cells. Unlike VMG data structures, VTS 
data structures often use the exotic capa¬ 
bilities found in PGCs. For instance, title 
cells can have up to nine different video 


Parental Levels 


T he initial wave of DVD titles had no 
parental enforcement. The second 
generation of titles (such as Disney 
and Universal) have parental controls, 
but are buggy. For example, Disney con¬ 
tent requires players to be at Parental 
Level Eight (see Examples 1 and 2) be¬ 


fore playback can commence, but Lev¬ 
el Eight isn’t even defined for the Unit¬ 
ed States! Hopefully, as the content ma¬ 
tures, parental enforcement will be less 
problematic. 

—L.D. 


Mov GPRM0, SPRM13 

LT GPRM0, 8 

GOTO Failure 

get value of system parental register and copy 
into a user register #0 
if parental level < Max parental level 
(i.e. 8) 

then alert user about the failure 

Example 1: Poor parental checks in DVD content. Instead of checking for 
the parental level required by the disc, the content forces the parental level to 
be at least Level Eight before it will run. 

Mov GPRM0, SPRM13 

LT GPRM0, #DISC_LEVEL 

GOTO Failure 

get value of system parental register and copy 
into a user register #0 

if parental level < the required parental level 
on the disc 

then alert user about the failure 

Example 2: Correct parental checks in DVD content. In this case, the 
content verifies that the parental level in the player meets the minimum 
requirement for the disc, rather than the arbitrary Level Eight in Example 1. 
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angles (an angle normally is an alternate 
camera angle of the presentation). Users 
can dynamically switch the viewing angle 
and the player will smoothly transition to 
a different location in the VOB file based 
on instructions in the cell. 

Title PGCs can also utilize either sim¬ 
ple or complex parental controls. Simple 
parental controls prevent a PGC from play¬ 
ing if users have not authorized its pre¬ 
sentation. They will present users with a 
warning message indicating that the pre¬ 
sentation cannot continue until users mod¬ 
ify the parental setting for the player. 

More sophisticated titles can dynami¬ 
cally select a different PGC depending on 
the current parental level. They have blocks 
of PGCs, only one of which will be dis¬ 
played based on the parental setting. For 
example, if the player is set for G-rated 
movies, a nonviolent PGC will be chosen. 
By contrast, if the player has an R setting, 
an alternate PGC in the parental block with 
violent content will be displayed. 

Unlike the VMG, a VTS categorizes 
menus into different topics: chapter, au¬ 
dio, angles, subpicture, and overall title 
control. These menus contain the same 
functionality as the VMGM including mo¬ 
tion video, background audio, and inter¬ 
activity via buttons. 

Although interactivity has been the most 
hyped feature in DVD menus, they offer 
other intriguing options. For instance, DVD 
menus can be multilingual. To explain, 
when you create a logical menu screen, it 
can contain multiple versions of the menu, 
each in a different language. When the 
menu is displayed, the DVD player will 


check the current language system and 
pick the appropriate menu system for that 
language. Consequently, you can ship the 
same disc to different areas of the world, 
and the DVD players in each region will 
use the appropriate menu for that language. 

Besides internationalization, DVD menus 
also support the same parental locking 
features found in title PGCs. You can use 
these parental controls to display com¬ 
pletely different menus depending on the 
current parental rating system. For exam¬ 
ple, if the player’s parental setting only 
permits G- rated movies, then the parental 
block would not show the default PG-13- 
rated menu, but instead show a special G- 
rated version that does not give viewers 
access to the chapters in the movie with 
sensitive content. 

(Many early DVD developers wanted 
their titles to play on both Windows 95 
and dedicated DVD Video machines. Be¬ 
cause their programs used the Media Con¬ 
trol Interface [which only uses VOB files 
and ignores the IFO required by DVD- 
Video], they had to create IFO files for 
DVD-Video compatibility. Unfortunately, 
they failed to follow the naming conven¬ 
tions for these files and were bitterly dis¬ 
appointed when they discovered that the 
content was unusable for DVD Video.) 

The DVD specification also defines the 
minimum set of interactive functions (or 
operations) a player must provide to the 
user. Since these capabilities are found in 
Annex J of the specification, they are of¬ 
ten referred to as “Annex J functions.” 
These commands can be divided into the 
following categories: user interaction via 


Region Management 


M any users have manually modi¬ 
fied their DVD player to ignore 
region management. This process 
is usually accomplished by setting all 
the bits (or enabling all regions) in the 
player’s internal region register. This 
hack initially allowed players to play 
content from any region of the world. 
However, content creators have em¬ 
bedded instructions in the DVD discs 
to validate that the region code of the 
player is legitimate. If the content de¬ 
tects that the player has an invalid re¬ 


gion code, it will refuse to play the 
movie (see Example 3) 

VMG is also the source of a contro¬ 
versial field—region control. To explain, 
the DVD specification places artificial lim¬ 
itations on where the disc may be played. 
If the region code for the player does not 
match the region code in the content, 
then the DVD specification will not let 
the player present the disc—even though 
the player can decode the content. 

—L.D. 


Mov GPRM0, SPRM20 

; get the region code of the player 

NE GPRM0, 1 

; If region code is not exactly ONE 

GOTO Failure 

; then either this is the wrong player or 
; the user hacked it. 


j. fwgiuu crjvcK* in cunieru. mis sample verifies wat we uv 
player running the content can play Region One — and only Region One- 
content by ensuring that only one bit in the region control register is set. If 
multiple regions are enabled, it will fail. 
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buttons, stream controls, random access 
to presentations, and menu manipulation. 

The specification offers commands to 
navigate through buttons ( UpperButton - 
SelectO, LowerButtonSelectO , LeftButton- 
SelectO, and RightButtonSelect(J). Once 
you’ve decided on a button, you can use 
ButtonSelectO or ButtonActivateO to 
make a selection. 

While a tide is playing, you can change 
the viewing angle via the Angle_Change() 
method. Audio_Strearn_Change() and 
Subpicture_Stream_Change() let you 
change audio and subpicture streams (or 
languages). If you’re in a still condition 
(such as a pause between slides in a slide 
show), StilljDffO causes normal playback 
to resume. 

There are a number of methods that en¬ 
able random access to content. If you wish 
to search through the title, you can search 
via time ( Time_Search() or TimeJPlayO ), 
by chapter ( Chapter_Play() and Chap- 
ter_Search(J), or by title ( TitleJPlayO ). 

The MenuCallC) function lets you dis¬ 
play a menu. It has one parameter that 
dictates which type of menu is displayed 
(Chapter, Audio, Subpicture, or Title). 
There are also methods to select Sub¬ 
picture or Audio streams C Subpicture_ 
Stream_Change() and Audio_Stream_ 
ChangeO, respectively), modify parental 


settings (Parental_Level_Select(J) , and 
change angles (Angle_CbangeO). 

Although Annex J defines the minimum 
set of interactive functions a DVD player 
must provide, it is legal, and in some cas¬ 
es, necessary to provide additional func¬ 
tionality for a specific platform. For in¬ 
stance, Microsoft’s DirectShow for Win32 
(a standard interface and the software 
drivers required for writing Windows-based 
DVD applications; see http://www.microsoft. 
com/directx/) provides enhancements that 
are specific to the computer environment 
and not addressed in the specification (see 
Listings One and Two; listings begin on 
page 96). It provides methods to process 
mouse input, finer control of the presen¬ 
tation, and support for asynchronous DVD 
events. Listing Two illustrates how you pro¬ 
cess DVD-related DirectShow events. 

Conclusion 

Unlike VHS, DVD is not simply a linear 
medium. It was designed to unite com¬ 
puter and consumer electronics users by 
offering high-quality video, multichannel 
audio, interactive functions, and a format 
that can adapt to future technologies. Fur¬ 
thermore, the DVD specification is hard¬ 
ware independent, so your content can 
run on a wide variety of devices. Once 
you begin to develop with DVD, you’ll 


never again want to return to today’s space 
constrained, postage-stamp-size multi- 
media world. 


For More Information 

Robert’s DVD Info: 
http://www.unik.no/~robert/ 
hifi/dvd/ 

Kilroy’s DVD FAQs: 
http://www.CD- info.com/CDIC/ 
Technology/DVD/dvd-faq.html 

Chad Fogg’s Technical Notes: 
http://www.mpeg.org/~tristan/ 
MPEG/DVD/ 

DVD-Video Production Guidebook: 
http://www.nbdig.com/html/ 
dvdmain.htm 

Quantel Digital Fact Book: 
http://www.quantel.com/ dfb/ 

Sonic DVD Primer: 

http://www. sonic.com/html/ 
dvd/PDF/primer.pdf 
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EMBEDDED SYSTEMS 


68HC05-Based 

Peripheral Devices: 

Part II 


The keyboard interface 
as a power supply and 
communications link 

Derrick B. Forte 
and Hai T. Nguyen 

A lthough the IBM AT’s keyboard port 
is the primary means of user input, 
you can also use it as the power 
supply and communications link for 
small low-power computer peripherals. In 
this two-part article, we present a system 
model around which such peripherals can 
be designed. The application we present 
is a Caller ID peripheral device based on 
the Motorola MC68HC(7)05P9 microcon¬ 
troller. This device is capable of receiving 
Caller ID transmissions and displaying the 
received data on an AT-compatible com¬ 
puter. Last month, we focused on the 
Caller ID protocol and hardware design 
issues. This month, we complete our dis¬ 
cussion of the hardware and zero in on 
the software. 

The authors are engineers at Motorola, 
and can he contacted at r20367@ 
email.sps. mot.com. 


The Caller ID Data-Acquisition Block 

The Caller ID data-acquisition block per¬ 
forms two functions within the applica¬ 
tion’s system design: 

• Provides an electrical interface to the 
telephone line. 

• Demodulates and validates the Caller ID 
analog signal and converts it to a digi¬ 
tal bit stream. 



Though many Caller ID designs imple¬ 
ment these functions with discrete analog 
circuitry, we selected a more integrated 
solution for this application—Motorola’s 
MC145447 Calling Line Identification Re¬ 


ceiver with Ring Detector. This device pro¬ 
vides the needed interface to the tele¬ 
phone line, demodulating the BFSK asyn¬ 
chronous data signal, and outputting a 
digital stream. The design of this block 
was largely taken from the application 
note section of the technical data sheet 
for the MC145447. The device also has 
a number of signal validation and pow¬ 
er saving features that are useful for 
Caller ID designs for which low power- 
consumption is an issue. Since this appli¬ 
cation is powered by the host computer’s 
keyboard interface, it does not use any of 
the MC145447 ’s power saving modes. 

The MC145447 ’s interface to the tele¬ 
phone line’s twisted pair can be divided 
into two types of signals: Caller ID data 
acquisition signals and ring detection and 
validation signals. The ring detection and 
validation signals serve to detect the pres¬ 
ence of a valid ring signal on the twist¬ 
ed pair and participate in bringing the 
device out of power-down mode. There 
are four signals that comprise the ring 
detection and validation portion of the 
interface. Three of the signals—Ring De¬ 
tect IN 1 (RDI1), Ring Detect IN 2 (RDI2), 
and /Ring Time (/RT)— are inputs. There 
is also one output—/Ring Detect Out 
(/RDO)—which is asserted when a valid 
power ring is detected on the telephone 
line twisted pair. The /RT pin works in 
conjunction with the RDI1 pin to gener¬ 
ate internal signals that are part of the 
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Figure 1: Keyboard Caller ID board schematics. 
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device’s power-up circuitry. To conserve 
power, the MC145447 ’s power-up cir¬ 
cuitry applies power to different sections 
of the device as they are needed. 

In the power-up sequence, the /RT 
and RDI1 signals are used to activate 
power to the Ring Analysis section of the 
device. This section determines whether 
a valid ring signal is present on the twist¬ 
ed pair. As the schematics in Figure 1 
shows, the voltage at the RDI1 pin is pro¬ 
vided by resistor RIO, which is part of a 
voltage divider circuit comprised of re¬ 
sistors RIO, Rll, and R12. (More complete 
schematics are available electronically in 
.EPS format; see “Resource Center,” page 
3.) The resistor network divides an AC 
coupled, rectified version of the voltage 
present between the tip and ring sides of 
the twisted pair into voltages that are 
sampled by the RDI1 and RD2 pins. The 
value of RIO is chosen such that if a volt¬ 
age of 40Vrms or more is present on the 
twisted pair, which indicates that a pow¬ 
er ring might be taking place, the RDI1 
pin and its associated circuitry will turn 
power on to the Ring Analysis circuitry. 
The /RT is connected to a RC combina¬ 
tion that holds the pin low during the low 
periods of a power ring. The RDI2 pin 
serves as the only input to the Ring Anal¬ 
ysis section. The signal at this pin is pro¬ 
vided by resistor R12 of the divider net¬ 
work. The duty cycle of this signal is used 
to validate the presence of a power ring. 
In the event that a power ring is detect¬ 
ed, the Ring Analysis circuit asserts the 
/RDO pin. 

The data-acquisition signals on the 
MC145447 consists of a Tip input (TI) 
and Ring input (RI) pin. The TI is AC 
coupled to the tip side of the telephone 
line’s twisted pair through capacitor C7. 
The RI signal is AC coupled to the Ring 
side of the twisted pair through capaci¬ 
tor C8. The signal that is presented to 
these two pins is demodulated and con¬ 
verted into the digital stream that is out¬ 
put by the device. 

In our application, the MCl45447’s in¬ 
terface with the system’s microcontroller 
consists of three pins — the Data Out 
Cooked (DOC) pin, the /Ring Detect Out 
(/RDO) pin, and the /Power Up 
(/PWRUP) pin. The MC145447 outputs 
a digital stream on two pins, which are 
the Data Out Cooked (DOC) pin and the 
Data Out Raw (DOR) pin. 

The DOR pin outputs the entire data 
stream demodulated by the device start¬ 
ing with the Channel Seizure and Mark 
Signals and ending with the checksum 
byte at the end of a transmission. The 
DOC pin, on the other hand, outputs 
data after a transmission passes an in¬ 
ternal data validation process and does 
not output the Channel Seizure and Mark 


Signals. Data is captured by the 
MC68HC(7)05P9 by connecting DOC to 
pin PC3 on the MC68HC(7)05P9, which 
is configured as an input. 

The /RDO pin is connected to pin PC2 
of the MCU, which is configured as an 
input. As stated earlier, the /RDO pin is 
asserted when a valid power ring is de¬ 
tected on the twisted pair. The assertion 
of the /RDO pin, along with the start of 
the transmission of data within 0.5-1.3 
seconds after the deassertion of /RDO, 
is used by the MC68HC(7)05P9 to qual¬ 
ify the start of a data stream from the 
MC145447. 

The MC145447 has a requirement that 
its /PWRUP pin be at a Logic 1 for a min¬ 
imum of IOjliS after VDD reaches its full 


value. Typically, this requirement is met 
by delaying the assertion of /PWRUP with 
a RC circuit. To eliminate the need for 
these two components, the /PWRUP pin 
is connected to the MC68HC(7)05P9’s 
PC3 pin, which is configured as an out¬ 
put. This pin asserts /PWRUP after an ap¬ 
propriate delay. 

The Keyboard- 
Interface Block 

The main function of the keyboard- 
interface block is to transmit Caller ID data 
captured from the MC145447 to an AT- 
compatible host computer through its key¬ 
board interface. Pins PAO and PA1 of the 
MC68HC(7)05P9 serve as the application’s 
keyboard interface’s data signal. PAO is 
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configured as an output and is used to 
transmit data to the keyboard interface. 
PA1 works in conjunction with PAO and is 
configured as an input. This arrangement 
satisfies the AT keyboard interface re¬ 
quirement that the keyboard interface data 
line be a bidirectional signal that is capa¬ 
ble of both transmitting and receiving data 
to/from the host. Pins PA2 and PA3 func¬ 
tion in a way that is similar to the PA0-PA1 
pin pair. PA2 is configured as an output 
and generates the clock signal required for 
both keyboard-to-host and host-to-keyboard 
data transfers, and PA3 is confirmed as an 
input that reads the level on the clock line. 
Though the clock signal never functions 
as an input as does the data line, the AT 
keyboard interface protocol requires that 
its level be monitored in the event that the 
host wishes to transmit data to the key¬ 
board. Since PAO and PA2 are not open- 
collector outputs, they cannot be directly 
connected to the data and clock signals of 
the keyboard and keyboard interface. 
Therefore, a 7407 open-collector buffer 
serves as the interface between the MCU’s 
keyboard interface signals and those of 
keyboard and the keyboard interface. 

The design of the keyboard interface 
does not allow the keyboard to be con¬ 
nected to the interface while another de¬ 


vice is transmitting to it. Therefore, the 
Caller ID device must disconnect the key¬ 
board’s clock and data signals from those 
of the keyboard interface whenever it 
transmits to the host. Port A pin PA5 is 
configured as an output and serves as the 
control signal for the 4066 analog switch¬ 
es that connect or disconnect the key¬ 
board’s signals to those of the interface. 
The number of tasks that a host comput¬ 
er’s CPU may need to perform may pre¬ 
vent it from processing a scan code at the 
time that it is received at the keyboard in¬ 
terface. To prevent user keystrokes from 
being lost, the keyboard-interface proto¬ 
col provides for a busy signal that the host 
sends to the keyboard to prevent it from 
sending scan codes until the host can pro¬ 
cess them. The host signals the keyboard 
that it is busy by holding the clock line 
low until it can accept new scan codes. 
While the host is busy, the keyboard stores 
the scan codes for new keystrokes in its 
internal buffer. To prevent the loss of any 
keystrokes that may be generated while 
the Caller ID device is transmitting to the 
host, the MC68HC(7)05P9 pulls the clock 
signal low after it disconnects the key¬ 
board’s signals from the interface. Port A 
pin PA5 is configured as a output and per¬ 
forms this function. 


Keyboard Caller ID Device 
Software-Design Overview 

The software design of this application 
is divided into two parts—the firmware 
that resides on the MC68HC(7)05P9 and 
CALLERID.EXE. The firmware’s main 
function is to capture the raw digital data 
stream generated by the MC145447 and 
transmit it to the host computer for fur¬ 
ther processing (source code for the 
firmware is available electronically; see 
“Resource Center,” page 3). Data is trans¬ 
mitted to the host in the form of key¬ 
board scan codes that are sent through 
the host’s keyboard interface. The host 
receives the scan codes and interprets 
them as keystrokes. The sequence of sim¬ 
ulated keystrokes is read by CAL¬ 
LERID.EXE, which parses and converts 
the string back into binary data from 
which it extracts Caller ID information. 
CALLERID.EXE (source code for CAL¬ 
LERID.EXE is available electronically) then 
formats and displays the data in a pop¬ 
up dialog box. This division of function¬ 
ality between the Caller ID device and 
the host computer allows for the greater 
portion of processing to be off loaded to 
the host computer where a larger amount 
of resources are available. This reduces 
the functionality of the Caller ID device 
thus allowing its design to be imple¬ 
mented with a smaller and cheaper micro¬ 
controller. 

Keyboard Caller ID 
Device Firmware Design 

As Figure 2 illustrates, the Caller ID de¬ 
vice’s firmware follows this program flow: 

1. On reset, the general I/O pins on the 
MC68HC(7)P9 are configured and ini¬ 
tialized to implement the Caller ID de¬ 
vice’s hardware design. 

2. The firmware waits in a loop for the 
assertion of the MC145447 ’s /RDO sig¬ 
nal that is monitored on the MC- 
68HC(7)05P9 ’s PC2 I/O pin. The as¬ 
sertion of this signal indicates that a 
power ring has been detected on the 
twisted pair. 

3. If the MC68HC(7)05P9 detects that the 
MCl45447’s /RDO pin is deasserted 
and a start bit on the DOC pin, the 
conditions are met for the MC- 
68HC(7)05P9 to begin monitoring for 
a transmission. 

4. The MC145447 transmits the CALLER 
ID data to the MC68HC(7)05P9 in the 
form of a raw digital stream on its DOC 
pin. The MCU reads the data from its 
PCO pin. 

5. On receiving the data from the 
MC145447, the MC68HC(7)05P9 parses 
the stream into individual bytes and 
checks the data for a parity error. If a 
parity error has been detected, it is 
flagged by a global variable, otherwise 



Figure 2: Keyboard Caller ID device firmware flowchart. 


76 


Dr. Dobb’s Journal, July 1998 

















































































fi.ftte.csu 


End The Search! 

Looking for development tools to 
improve program performance, 
reliability, and memory usage? 

Look no further! Diab Data’s new 
RTA Suite represents a quantum 
leap forward in the quest for this 
exciting new class of tools. 

The RTA Suite 
Diab Data’s RTA (Run-Time 
Analysis) Suite allows you to 
capture and analyze your code’s 
run-time behavior, providing you 
with the critical run-time insight 
you need to maximize program 
performance and reliability. Combined with 
Diab Data’s industry-leading D-CC™ and 
D-C++™ compiler suites, the RTA Suite 
enables you to develop faster, higher 
quality code in less time. 


Powerful Run-Time 
Analysis Tools 
A Visual Interactive Profiler 
for a revealing view of run¬ 
time program behavior, 
including hierarchical “top- 
down” analysis of parent/ 
children function pairs. 

A Run-Time Error Checker 
for detecting memory leaks, 
hard-to-find pointer errors, 
stack overflows, and many 


A Visual Link Map Analyzer 
for interactive “drag-and-drop” 
optimization of memory maps. 

For Every Developer 
The simplicity of the RTA 
Suite’s graphical user interface 
makes it useful for every 
developer on your team. Now 
every developer can benefit 
from application specific 
optimizations and the ability 
to enhance code quality 
before Q.A. What’s more, the 
BBHBP RTA Suite is integrated with 
leading development 

environments such as ISI’s pRISM+™, SDS’ 
SingleStep™, Enea OSE Systems’ Illuminator™, 
and others, so you can access the RTA Suite 
from familiar tools. 


...With The RTA Suite 


95 =? 


Diab Data: 

The Expert's Choice 

Diab Data is the compiler 
leader for embedded 
PowerPC and Motorola 
RISC applications. So 
when you are ready to take 
your PowerPC, 68K/ 
CPU32, ColdFire, or 
MOORE project to the 
next level, don’t fumble 
around in the dark. Call 
on the 
experts. 


other conditions associated with invalid memory references at run-time. And see what you have been missing with the RTA Suite! 


PtabAdaia 


EMBEDDED 


Defining Compiler Performance 

Diab Data, Inc., Tel: 650.571.1700, Fax: 650.571.9068. Diab Data GmbH, Tel: +49 (0)89-9393.1191, Fax: +49 (0)89-930.5184 

© 1998, Diab Data, Inc. All Rights Reserved. All trademarks used are the property of their respective holders. 


Browse Us www.ddi.com Email Us info@ddi.com 


































































(continued from page 76) 
the data is converted into an array of 
AT keyboard scan codes for transmis¬ 
sion to the host computer. 

6. The application transmits a <CONTROL 
L> keystroke sequence as a series of 
scan codes. This interrupts the appli¬ 
cation that currently has the focus in 
Windows 95, activates CALLERID.EXE, 
and gives it the focus. 

7. If a parity error was not detected during 
the reception of the CALLER ID data, the 
scan code array that represents the re¬ 
ceived data is transmitted to the host 
computer, otherwise an error code is sent. 

8. The firmware returns to monitoring the 
twisted pair for a new Caller ID trans¬ 
mission. 


The firmware’s functions can be divid¬ 
ed into three types of routines: 

• Device initialization routines. 

• Caller ID data-acquisition routines. 

• Keyboard interface routines. 

The device initialization routines config¬ 
ure and initialize the MC68HC(7)05P9’s I/O 
pins to implement the application’s hard¬ 
ware blocks. As mentioned earlier, Port A 
I/O pins PA0-PA5 are configured to im¬ 
plement the keyboard interface block, while 
three Port C pins, PCO, PCG, and PC3, serve 
as the MC68HC(7)05P9’s interface to the 
MC145447. All remaining general-purpose 
I/O pins are configured as outputs to elim¬ 
inate the need for pull-up resistors on them. 
The data acquisition routines of the 
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firmware consists of the sampling and time 
delay routines that capture data from the 
MCl45447’s DOC line. The MC68HC(7)05P9 
samples the data stream at its PC3 pin and 
parses it into individual bytes. The fact that 
each piece of Caller ID data begins with a 
start bit and ends with a stop bit, makes it 
easy to delineate between individual bytes. 
The time delay functions used for data ac¬ 
quisition routines are not only used to sam¬ 
ple the bits within a byte but must also al¬ 
low for the inter-character delays that the 
Interface allows. 

The keyboard-interface firmware main¬ 
ly consists of a transmission routine and 
its accompanying time delay functions. 
The keyboard interface’s transmit function 
has within it a call to a routine that is ca¬ 
pable of receiving host computer com¬ 
mands. If the host computer detects an 
error in the data that was sent to it by the 
keyboard, the host will hold the data low 
after bad transmission. The host will then 
send a Resend command (OxFE) to the 
keyboard requesting a retransmission of 
the data. Therefore, the Caller ID device 
must have a receive routine in the event 
that an error occurs. 

For this application, the number of re¬ 
transmission attempts was arbitrarily set 
at 1. Therefore, if an error occurs when 
the device sends a byte to the host, the 
device will capture the host’s resend com¬ 
mand and attempt a retransmission of the 
data. If the retransmission fails, the device 
will reconnect the keyboard’s clock and 
data signals to those of the host and re¬ 
turn to monitoring the telephone line. To 
transmit data to the host, the transmission 
routine toggles PA0, which is the data out¬ 
put signal, and the PA2 pin, which is the 
clock output signal, in accordance with 
the timing specifications for keyboard-to- 
computer data transfers. The host com¬ 
mand reception routine reads the data 
from the PA1 pin and toggles the clock 
signal in accordance with the timing spec¬ 
ifications for computer-to-keyboard data 
transfers. 

CALLERID.EXE Design 

CALLERID.EXE’s design is divided into 
two parts — CALLERID.EXE (the exe¬ 
cutable program) and CALLDLL.DLL (the 
DLL containing the global hook func¬ 
tion). Both modules were compiled with 
Microsoft Visual C++ Version 2.0. CALL- 
DLL.DLL’s code consists of a function to 
install the keyboard hook function and 
the hook function itself. In the code’s 
call to the Windows API’s SetWindows- 
HookEx function, the idhook parameter 
is set to WH_KEYBOARD, which is a 
predefined value that configures the 
hook function to handle keyboard 
events. This code is placed in a DLL be¬ 
cause Windows 95 requires that global 
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hook functions reside in a DLL. The 
keyboard-hook function in this 
application must be global in scope so 
that CALLERID.EXE can be invoked re¬ 
gardless of what application may cur¬ 
rently have the focus in Windows 95. The 
only limitation with CALLERID.EXE is that 
it will not be invoked if the current win¬ 
dow with the focus is a DOS window. 

The main function of the executable is 
to receive the Caller ID data from the 
Caller ID device, format it, and display it 
in a dialog box on the PC’s monitor. As 
Figure 3 illustrates, the program flow of 
the executable is as follows: 

1. CALLERID.EXE is invoked immediate¬ 
ly after Windows 95 boots up. The main 
window of the CALLERID application 
is initialized to come up in the hidden 
state. This causes CALLERID.EXE to be¬ 
gin executing in the background of 
Windows 95. 

2. CALLERID.EXE accesses CALLERID.DLL 
and installs the keyboard hook function 
into the Windows 95 stream. The hook 
function now examines each keystroke 
that is entered by the user for the CON¬ 
TROL L> hotkey sequence. 

3. On detecting a <CONTROL L> key 
combination, the keyboard hook func¬ 
tion calls the Windows API FindWin- 
dow (), function to locate the applica¬ 
tion’s hidden main window. The 
Windows ShowWindowO function is 
then called to activate CALLERID.EXE’s 
main window and give it the focus in 
Windows 95. 

4. CALLERID.EXE displays a pop-up dia¬ 
log box on the monitor displaying the 
text: “Receiving Data...”. 

3. The application waits for a keystroke 
from the Caller ID device. 

6. If CALLERID.EXE receives a charac¬ 
ter from the Caller ID device, the device 
has detected a parity error in the Caller 
ID data received from the telephone line. 
The CALLERID.EXE will then display 
“Line Error” in the dialog box: Other¬ 
wise, it acquires the full stream of Caller 
ID data from the device. 

7. C-string manipulation functions are 
used to parse the string into the two 
character segments that represent each 
byte of Caller ID data. C string conver¬ 
sion functions are then used to convert 
each ASCII segment into the original bi¬ 
nary data that was captured on the 
Caller ID device. 

8. CALLERID.EXE formats the binary data 
so that it can be displayed in the di¬ 
alog box. CALLERID.EXE will format 
data according to whether the Caller 
ID data received is in the SDMF or 
MDMF format. 

9. The Caller ID information is displayed 
in the dialog box. The dialog box re¬ 


mains displayed until users press one 
of the box’s OK or Deactivate buttons. 
lO.The dialog box is hidden again if the user 
presses the OK button. CALLERID.EXE 
then returns to waiting for a hot key 
sequence. If the Deactivate button is 
pressed, CALLER.EXE will be deacti¬ 
vated and will no longer function un¬ 
til Windows 95 is reset. 

Keyboard Caller ID 
Device Operating Instructions 

To use the Keyboard Caller ID system 
we’ve presented here: 

1. Copy CALLERID.EXE to the hard drive 
and directory of your choice. A sug¬ 
gested path might be: C:\CALLERID\. 


2. Copy CALLDLL.DLL to the C:\WIN- 
DOWS\ SYSTEMX directory. 

3. Add CALLERID.EXE to the Wmdows 95 
Start Menu. 

4. Disconnect the keyboard’s connector 
from the host computer’s keyboard 
port. 

5. Connect the Keyboard Caller ID de¬ 
vice to the host computer’s keyboard 
interface. 

6. Connect the keyboard’s connector to 
the receptacle for it on the Keyboard 
Caller ID device. 

7. Connect the telephone line to one of 
the R-Jll connectors on the Keyboard 
Caller ID device. 

8. Connect a telephone extension line be¬ 
tween the Keyboard Caller ID’s second 


Rapido, Schnell, 
Hayaku, Fast. 

In Every Language, 

Velocis Means 'Fast Database' 

u 


■(I Programming 


For years, serious C and C++ programmers 
have called on Raima’s DBMS when they 
want the ultimate in database performance. 
Now your Visual Basic, Java or Delphi 
application can incorporate Raima’s highly 
optimized engine and get the same 
advantages: low cost, portability, low 
memory requirement, compact executables. 
And data access an order of magnitude 
faster than other databases. 


Want faster applications? 

We're talking your language. 

Visit our Web Site at: 
www.raima.com 
or call 1-800-327-2462 

If it's fast-it's 

rAim jx 



Dr. Dobb’sJournal, July 1998 


79 














Ultimate TCP/IP 


Your Ultimate Answer 


SMTP/POP3 

MIME l/ 

NNTP 

FTP 

HTTP V 

DNS j/ 

MFC j/ 

C++ 

ActiveX j/ 

Clients 

Servers y" 

NT Services 

Firewall Friendly j/ 

Custom | / 

Protocols V 

Multi-threaded ,/ 

Capable V 

Royalty Free |/ 


Special pricing for Team 
licenses available. 


Developing high quality, Internet 
enabled applications can be a 
difficult task. Difficult if you’re not 
using Ultimate TCP/IP that is. 

Ultimate TCP/IP was designed to 
make your job as an application 
developer easier. Whether you’re 
writing an e-mail enabled appli¬ 
cation with MIME support, or a 
custom TCP/IP server to dissem¬ 
inate information throughout your 
Intranet, Ultimate TCP/IP gives 
you the tools you need. 

Ultimate TCP/IP is very easy to 
use and integrates painlessly 
with new and existing develop¬ 
ment projects. 

Ultimate TCP/IP includes 100% 
full source code, designed so 
you can easily modify, enhance, 
and understand it. 

Ultimate TCP/IP also includes a 
convenient collection of drop-in 
ActiveX components for those 
development projects that don’t 
require the high power of C++. 

The Ultimate TCP/IP Enterprise 
edition includes an Ultimate 
pocketTCP™ toolkit for Windows 
CE development. 

Ultimate Guarantee 

It’s simple. We guarantee your satisfaction. We guaran¬ 
tee that you will have full access to our tech support for 
a year. If you find Ultimate TCP/IP doesn’t fit your 
needs, we provide a 30-day money back guarantee. 


DUNDAS 


nEfrnEBHgiMt n 

sales 416.239.7472 fax 416.239.2183 

emafl sales@dundas.com www www.dundas.com 



Figure 3: CALLERID.EXEprogram flowchart. 


R-Jll connector and your telephone. This completes the hard¬ 
ware installation of the Keyboard Caller ID device. 

9. Shut down and restart Windows 95. 

10. Caller ID should now activate. Caller ID will display a dialog 
box with Caller ID information every time a valid transmis¬ 
sion is received. To deactivate the program, press the Deac¬ 
tivate button in the dialog box. 
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Application Development Tools 

"We initially coded algorithms ii 
Matlab and then converted the 
Matlab source to C or C++. To our 
surprise, the Matlab code was 
faster in nearly all cases." 

Jack Staub 
Hughes Aircraft 
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Interactive GUI Design 
"In one day, I wrote 875 lines of 
Matlab which equates to 5,000 
lines of C code. I had a functioning 
GUI in one day. You can't do that 
with C." 

Kathleen Splaine 
Risk International 
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Analysis and Visualization 

complex modeling and simulation 
can be done in a fraction of the 
time it would take to write your 
own code." 

Gregory E. Chamitoff, Ph.D. 

NASA, Johnson Space Center 
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Sample #3: Accessing Attribute Values 

The Car elements in Figure 2 have at¬ 
tributes for price and currency informa¬ 
tion. These can be accessed in XSL by 
escaping to the ECMAScript scripting lan¬ 
guage. XSL provides an eval element that 
can be used to house script code. In List¬ 
ing Three(a), the rule is modified to let 
Car elements access the attribute infor¬ 
mation. Listing Three(b) is the HTML from 
this modified stylesheet. 

The CDATA section in the eval ele¬ 
ment is an XML construct that shields 
text from the attentions of the XML pars¬ 
er. The CDATA section begins with the 
“<![CDATA[” string and ends at the “]]” 
string. It is a good idea to use CDATA sec¬ 
tions to shield script code, since charac¬ 


ters such as “<” and can have spe¬ 
cial meanings to an XML parser. 

Sample #4: Creating a Table 

Listing Four(a) is a stylesheet creating a 
simple HTML table layout of “car for 
sale” information. Listing Four(b) is the 
result of applying this stylesheet to the 
XML file. 

• All attribute values for the HTML flow 
objects must be quoted to make the 
stylesheet well-formed XML. The cor¬ 
rect way to specify a table with a bor¬ 
der is <TABLE BORDER="l">. The syn¬ 
tax <TABLE BORDER=l>, which is 
HTML valid, generates a parsing error 
in MSXSL; see Example 1. 


• The first cell in each table row contains 
the relative number of the Car —1, 2, 
and so on. This number is automatical¬ 
ly generated by the childNumber() func¬ 
tion. The built-in XSL functions for au¬ 
tomatic numbering are useful in creating 
stylesheets. 

Figure 3 shows what the generated HTML 
file looks like in Internet Explorer 4.0. 

Sample #5: Rearranging Content 

With XSL, it is possible to exert control over 
the order in which elements in the source 
document are processed. This allows doc¬ 
ument content to be selected and rear¬ 
ranged prior to creating the output. In List¬ 
ing Five(a), a table of car maker names is 
created; Listing Five(b) shows the result of 
applying this stylesheet to the XML file. 

Only the Maker element data has ap¬ 
peared in the output. This is because the 
select-element element indicates that only 
the Maker children of Car elements are 
processed. By default, the select-element 
element looks at the children of the cur¬ 
rent element to find matches. It is also 
possible to arrange for select-element to 



Figure 1: The XSL philosophy. 


C>type cars.xml 
<?xml version = "1.0"?> 

<CarsForSale> 

<Car Price = "10000" Units - "Dollars'^ 
<Maker>Toyota</Maker> 
cCondition Type = "Good"/> 
<Color>Red</Coior> 

</Car> 

<Car Price = "20000" Units = "Irish Punts"> 
<Maker>Ford</Maker> 
cCondition Type = "Good"/> 
<Color>Whitec/Color> 

</Car> 

</CarsForSaie> 


Figure 2: Typical XML document. 



Figure 3 • Typical generated HTML file 
viewed using Internet Explorer 4.0. 
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pages, columns, paragraphs, table cells, 
and so on. 

Platform-Independent Flow Objects. 

XSL specifies a set of standard flow ob¬ 
jects such as paragraph, page sequence, 
table, and the like. Using these platform- 
independent flow objects lets you create 
multiple output notations with a single XSL 
stylesheet. The type of notations that can 
be created is limited only by the back-end 
notations supported by the XSL processor. 
Strong candidates for XSL back ends in¬ 
clude RTF, FrameMaker MIF, and TeX. 

HTML-Specific Flow Objects. To fa¬ 
cilitate the use of XSL stylesheets to gen¬ 
erate HTML, XSL provides a set of HTML- 
specific flow objects. Given the vast 
amount of HTML-aware software in exis¬ 
tence, it makes sense to use this software, 
while simultaneously retaining the ad¬ 
vantages of XML over HTML as a data rep¬ 
resentation. 

Construction Rules. Flow-object con¬ 
struction in XSL is controlled by rules in 
the XSL stylesheet. These rules specify 
what flow objects are to be created and 
what they should contain. Flow objects 
can be thought of as containers for doc¬ 
ument content and/or other flow objects 
creating a tree-like hierarchy known as a 
“flow-object tree.” Flow-object construc¬ 
tion rules take the form of a pattern and 
action. The pattern part specifies the con¬ 
ditions under which the rule triggers. The 
action part specifies what flow objects to 
construct. 

Characteristics. Flow objects can have 
associated characteristics that differ de¬ 
pending on the type of flow object be¬ 
ing constructed. A paragraph flow object, 
for example, might have margin and tab 
characteristics. A table cell might have 
border and spanning characteristics. The 
characteristics to be applied to flow ob¬ 
jects can be controlled in the XSL style- 
sheet by means of style rules. Style rules 
take the same general form as constaic- 
tion rules, and consist of pattern and ac¬ 
tion components. 

Scripting. No stylesheet language that 
provides a fixed set of rendering capabili¬ 
ties can provide all the processing power 
needed. There comes a point where a “Tur¬ 
ing Complete” programming language is 
the best way to get the job done. The XSL 
draft specifies ECMAScript (a standardized 
version of JavaScript—ECMA 262) as a 
built-in scripting language. A number of 
mechanisms are provided in XSL for es¬ 
caping to ECMAScript to perform calcula¬ 
tions, define functions, and so on. 

Introducing MSXSL 

MSXSL is Microsoft’s technology preview 
implementation of the XSL draft specifi¬ 
cation. Don’t confuse it with MSXML, 
which is Microsoft’s implementation of an 


XML parser. Indeed, MSXSL uses MSXML 
to parse and load XSL stylesheets. 

MSXSL focuses on creating HTML from 
XML and, for the time being, only sup¬ 
ports HTML flow objects. The simplest 
way to use MSXSL is via the provided 
command-line utility that takes the input 
XML file (-i), input stylesheet file (-s), and 
output HTML file (-o). For example, the 
command C>msxsl -ifoo.xml -s foo.xsl -o 
foo.htm processes the foo.xml file with re¬ 
spect to the foo.xsl stylesheet specification, 
then generates the foo.htm output file. 


MSXSL is 
Microsoft’s 
technology preview 
implementation of 
the XSL draft 
specification 


To illustrate how to use XSL and 
MSXSL, I’ll return to the XML document 
(see Figure 2) presented in my February 
1998 article. 

Sample #1: Getting Started 

Listing One(a) (listings begin on page 97) 
creates a simple stylesheet to convert the 
XML document in Figure 2 to HTML. Some 
things to note about this stylesheet: 

• It is an XML document and uses a set 
of element types— xsl, rule, root, and 
so on— defined by the XSL language. 
The tags for these elements appear in 
lowercase. 

• It signifies the creation of HTML flow 
objects by using HTML tags—BODY, 
TITLE, and so on. These tags appear in 
uppercase. 

• It consists of a single flow-object con¬ 
struction rule. The pattern that triggers 
the rule is the root element (<root/>). 


• The children element (<children/>) tells 
the XSL processor that all the children 
of the element that triggered the con¬ 
struction rule should be processed, and 
the results of processing these elements 
should be inserted into the output flow- 
object tree. 


Listing One(b) is the result of process¬ 
ing the XML document with this style- 
sheet. While it’s hardly the world’s most 
exciting HTML file, there are some im¬ 
portant things to note: 

• All the data content of the XML docu¬ 
ment (the content of the Maker and Col¬ 
or elements) has found its way into the 
output document. The default in XSL is 
that the content of elements that do not 
trigger constaiction rules simply flows 
over to the output document at the point 
where it is encountered. 

• The attribute values (Price, Units , and 
Type) do not appear in the output doc¬ 
ument. This is also the result of the de¬ 
fault behavior of XSL. 

Sample #2: Rudimentary Formatting 

Listing Two(a) adds a few more con¬ 
struction rules to create slightly more 
pleasing HTML output, while Listing 
Two(b) presents the result of processing 
the XML document with this stylesheet. 
Things to note about this stylesheet and 
the resultant HTML include: 

• The pattern part of the flow-object con¬ 
struction rules use the target-element 
element, which can be used in a vari¬ 
ety of ways to specify context-sensitive 
rules. Here, I used the simplest form in 
which the target-element is an empty 
element (denoted by the slash in 
<target- element/>). 

• The same construction rule can be 
triggered for multiple element types 
by specifying multiple empty target- 
element elements. I’ve used this to cause 
the same rule to trigger on Condition 
and Color elements. The paragraph gen¬ 
erated for the Condition element is 
empty because attribute values are not, 
by default, included in the output doc¬ 
ument. 

• The stylesheet is an XML document and, 
thus, must be well-formed XML. This is 
why the HR flow object uses XML syn¬ 
tax to indicate it is an empty element 
(<HR/>). 


Omsxsl -i cfs.xml -s cfs4.xsl -o cfs4.htm 
Error in style sheet 'cfs4.xsl' 
ParseException: Expecting name instead of '1' 
Location: file:///C:/D0BBS/cfs4.xsl (9,17) 
Context: <xsl><rule> <HTML><BODY><TABLE> 


Example 1: MSXSL parsing error. 


Dr. Dobb’s Journal, July 1998 


83 









search all descendants by specifying the 
value "Descendants" to the optional from 
attribute: <select- elements from = "De¬ 
scendants'^. The <children/> element 
used in previous examples is shorthand 
for <select-elements from = "Children" > 

Sample #6: Scripting 

As a final example, the stylesheet in List¬ 
ing Six(a) uses ECMAScript to present all 
prices in Irish Punts in the generated 
HTML; Listing Six(b). The define-script 
element is used to create global variables 
and functions, and the eval element is 
used to invoke functions and access glob¬ 
al variables. 

XSL and CSS 

Although Cascading Style Sheets (CSS) can 
be used to render XML documents, XSL 
provides many more capabilities than CSS. 
With CSS, the document structure is es¬ 
sentially fixed and is simply mapped onto 
the available flow objects. With XSL, the 
document structure can be rearranged and 
can be processed multiple times. For ex¬ 
ample, with XSL is it possible to perform 
a traversal to generate a table of contents, 
then perform a second traversal to render 
the content proper. Also, XSL is pro¬ 
grammable via ECMAScript, thus provid¬ 
ing a Turing Complete environment in 
which to create rendering effects. 

(On the other hand, CSS is simple and 
familiar to many HTML users, and work 
is underway at Hewlett-Packard to create 
an extended implementation of CSS, 
known as “Spice,” which makes up for 
some of these deficiencies.) 

XSL and DSSSL 

XSL draws heavily on the concepts used 
in the Document Style and Semantics 
Specification Language ISO 10179 (DSSSL) 
Standard for SGML rendering. The DSSSL 
Standard uses a programming language 
based on Scheme as its expression lan¬ 
guage. Many of the DSSSL designers have 
been instrumental in the design of XSL, 
and work is underway to make the XML- 
based expression language of XSL for¬ 
mally a part of the DSSSL international 
Standard. Henry Thompson of the Uni¬ 
versity of Edinburgh has developed the 
XSLJ conversion utility that converts XSL 
specifications into DSSSL specifications. 
These can then be used with implemen¬ 
tations of the DSSSL Standard such as Jade 
(http://www.jclark.com/). 

Conclusion 

XSL is an important part of the overall vi¬ 
sion of XML. The core XML effort has 
three separate strands—XML itself, XML 
rendering (XSL), and XML hypertext link¬ 
ing (XLL). The speed with which compa¬ 
nies such as Microsoft have moved to im- 


For More Information 

XSL Draft Specification: http://www.w3.org/TR/NOTE-XSL.html 

Microsoft’s MSXSL XSL Processor 

Technology Preview: http://www.microsoft.com/xml/ 

XSL Discussion List and Archive: http://www.mulberrytech.com/xsl/xsl-list/ 
XSL-J (XSL to DSSSL Conversion Utility): http://www.ltg.ed.ac.uk/~ht/xslj.html 
Jade DSSSL Engine: http://www.jclark.com/ 

DSSSL Discussion List and Archive: http://www.mulberrytech.com/dsssl/dssslist/ 


plement XSL has come as something of a 
surprise to many. Even in its current ba¬ 
sic state, MSXSL is capable of real work 
and provides a glimpse of the capabilities 
you can expect in the next generation of 


web browsers, which should process and 
render XML directly. 

DDJ 

(Listings begin on page 97.) 
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PROGRAMMER'S TOOLCN ESI 



Examining the Dragon 
Speech-Recognition System 

Speech enabling your Windows apps 
Al Williams 


R emember the movie 2001: A Space 
Odyssey ? One of the most memo¬ 
rable characters in that movie was, 
of course, “Hal” the computer. Like 
most movie computers (the exception be¬ 
ing the Macintosh in Star Trek IV), Hal 
was smart and spoke with humans. Well, 
it isn’t quite 2001, but it’s getting pretty 
darned close, and still, real computers 
don’t speak and understand as well as 
their movie counterparts. However, recent 
developments have brought a plethora 
of voice-recognition tools for Windows. 
Though these tools are mainly for dictat¬ 
ing into word processors, as a developer 
you can certainly think of other applica¬ 
tions. Wouldn’t it be nice to piggyback 
your program on an existing voice recog¬ 
nition system? You can, using toolkits such 
as Dragon Systems’ DragonXTools. 

DragonXTools visual controls make it 
possible for you to speech-enable Win¬ 
dows applications with up to 60,000-word 
dictation using Visual Basic, Visual C++, 
and other development tools that support 
VBX/OCX controls or C-callable libraries. 
Users then use DragonDictate for Win¬ 
dows to enter text, data, and commands 
into Windows apps simply by speaking. 
You can distribute the DragonXTools cus¬ 
tom controls royalty free. However, you’ll 
need run-time licenses to distribute Drag¬ 
onDictate for Windows. 

In this article, I’ll show how to use 
DragonXTools custom controls to add 
speech recognition to programs. In do¬ 
ing so, I’ll use Visual Basic 5 to write a 
voice-activated autodialer (available elec¬ 
tronically; see “Resource Center,” page 3). 
Since the controls are ActiveX controls, 


ATs most recent book is MFC Black Book 
(Coriolis, 1997). He can be contacted at 
http://www. al- williams, com/. 


however, you can use most any language 
with them. 

How Does it Work? 

Even if you do not take special action, 
DragonDictate still works with your pro¬ 
gram, although it may not work well, de¬ 
pending on how your program is writ¬ 
ten. When DragonDictate sees your 
program running, it scans your menu 
items and control captions. Since Drag¬ 
onDictate generates its own speech mod¬ 
els, it can respond to users speaking your 
menu items and control captions. Of 
course, some captions work better than 
others. Sometimes DragonDictate can’t 
determine an appropriate speech mod¬ 
el. Also, if you use custom controls for 
graphical buttons, DragonDictate can’t 
decide what that means. 

DragonDictate operates in either com¬ 
mand or dictate mode. Usually, Dragon¬ 
Dictate is in command mode, which lets 
you speak menu commands, or key 
names. In command mode, you can op¬ 
erate the computer without using a 
mouse or a keyboard. However, entering 
text in command mode is a chore. You’d 
have to speak each letter individually. In¬ 
stead, when you want to enter text you 
say “dictate mode.” Now, DragonDictate 
interprets user speech as words until you 
say the command “command mode.” 
(One problem is that users must re¬ 
member to enter dictation mode. A 
speech-aware program might handle this 
automatically.) 

In short, it isn’t strictly necessary to al¬ 
ter your programs in any way to make 
them work with DragonDictate. However, 
with DragonXTools, you can get signifi¬ 
cant benefits. For example, you can set 
your own pronunciations for words that 
DragonDictate might misinterpret (or 


graphics that DragonDictate can’t read at 
all). You can also respond to words with 
your own actions, use DragonDictate’s 
macro language, and share the sound sys¬ 
tem with DragonDictate (many sound 
cards can only listen or talk at one time). 

The DragonXTool Toolkit 

DragonXTools includes a control that lets 
you recognize speech and interact with the 
Dragon engine, and another that converts 
plain text into speech. This works about as 
you expect; the speech sounds computer¬ 
generated, which is not always pleasing. 

Using the components isn’t difficult and 
the manual provides examples to help you 
get started. The examples are for VB, but 
the manual includes advice on how to use 
the components in C++, Delphi, and Java 
as well. 

Dragon separates words it will recog¬ 
nize into vocabularies and groups. It scans 
different vocabularies depending on the 
current situation. The Dragon speech con¬ 
trol lets you manage vocabularies and 
groups. You can create new words, and 
control which groups Dragon examines 
for speech recognition. 

Like all ActiveX controls, the Dragon 
control has properties, methods, and 
events. Table 1 is a list of the members 
used in the VB program I present here. 
Many functions that you’ll need to use re¬ 
quire you to access Dragon’s scripting lan¬ 
guage (via the Script property). 

Using the controls is straightforward 
once you get the hang of it. You first have 
to make sure DragonDictate is running. 
If it isn’t, you can start it before your pro¬ 
gram proceeds using something like Ex¬ 
ample 1. Once DragonDictate is running, 
you have to attach your speech control 
to the speech recognition engine. You can 
do this with the Attach property. Then 
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(continued from page 86) 
you are ready to begin creating your own 
vocabularies. You can set the currently 
active vocabulary and group using the 
Vocabulary and Group properties. When 
Dragon recognizes any of the words in 
your control’s group, it sends an event 
so that you can act on the word. 


Problems 

Although the tools are generally easy to use, 
I did find a few things I wish had been dif¬ 
ferent. First, DragonDictate doesn’t work well 
under Windows NT. The Dragon web site 
(http://www.dragonsystems.com/) has a 
FAQ about this. You can use Dragon and 
the tools under NT, but the behavior is 


quirky. Occasionally, you’ll be thrown into 
another window, for example. Worse, dur¬ 
ing development, the system frequently 
crashes and hangs VB. This seemed to have 
something to do with breakpoints, so I don’t 
expect it would be a problem in the 
shipped program, but it sure made writing 
software a chore. 

Another thing I thought odd is the way 
Dragon handles sleeping. If you are like 
me, you can’t really leave your micro¬ 
phone on all the time for DragonDictate 
to listen. There are phones ringing, dogs 
barking, and all manner of other noises 
in my office. Suppose you are dictating 
text into a program and the phone rings. 
You can say “go to sleep,” which puts 
Dragon in a dormant state. It still listens, 
but it doesn’t do anything until you say 
“wake up.” However, DragonDictate still 
notifies you when it recognizes any of 
your words. That means you have to know 
if Dragon is asleep or not. However, you 
can’t ask Dragon if it is asleep. If you want 
to handle this problem, you have to de¬ 
fine your own “go to sleep” and “wake 
up” commands and do the work yourself. 
Then you’ll still get the events for other 
words, but your program will know it 
should be asleep. The Dragon manual has 
examples of several ways to do this. 

The Design 

I’ve always thought the voice-activated 
autodialers on some high-end telephones 
are a great idea. You just speak a name 
into the phone and it dials away. (And 
before you ask, yes, you can get a head¬ 
set that works with Dragon and your 
phone.) For the first cut, I tried to make 
the program understand the name I was 
saying and I figured I would store the 
phone numbers in a flat file or database. 

As I got the speech part working, I re¬ 
alized I really didn’t need a database, since 
I could store the phone number and name 
along with the speech model. Of course, 
you don’t want to have to say the name 
and the number to dial on the phone, 
right? That defeats the whole purpose. 
However, Dragon lets you specify alter¬ 
nate pronunciations for words, as I’ll show 
you in a bit. Since users have their own 
vocabulary, that means individual users 
also have a private phone book. 

Figure 1 shows a completed dialer ap¬ 
plication. You don’t need any special code 
or controls to handle the three buttons— 
Dragon takes care of them automatically. 
But you do need some special work to 
make the phone automatically dial when 
you speak a name. 

When you say “add” or click the Add 
button, the program brings up a simple 
form that lets you make a new entry. The 
form has two fields, Name and Number , 
that you can jump to by simply saying the 


Name 

Type 

Description 

DDWinShutDown 

Event 

DragonDictate Shut Down. 

MicChanged 

Event 

Microphone turned on/off. 

UserChanged 

Event 

User changed. 

SpeechRecognized 

Event 

Dragon recognized a word in the control’s 
current group. 

SpeechActionComplete 

Event 

Dragon completed all actions for a 

recognized word (in any active group). 

SpeechRejected 

Event 

Dragon couldn’t recognize a word or 
phrase. 

Version 

Property 

Version number. 

Attach 

Property 

Sets to True to attach to the Dragon engine. 

EventsEnabied 

Property 

Lets you control the delivery of events to 
your application. 

Group 

Property 

Set current group. 

Vocabulary 

Property 

Sets current vocabulary. 

GroupCaption 

Property 

Sets text in voice bar. 

GroupFirst 

Property 

Gets first group as a prelude to iterating 
through the groups in a vocabulary. 

GroupNext 

Property 

Continues iterating through the groups 
(see GroupFirst). 

Word First 

Property 

Gets first word in a group as a prelude to 
iterating through the words in a group. 

WordNext 

Property 

Continues iterating through words. 

IgnorelnDictation 

Property 

Set to True if you want the Dragon engine 
to ignore your active words while in 
dictate mode. 

Microphone 

Property 

Lets you turn the microphone on, or 
disable it (which frees it and the 
associated sound system for other 
tasks). 

Repetitions 

Property 

Sets default number of training iterations 
used for training. 

Script 

Property 

Setting this property causes the Dragon 
engine to execute commands in its 
script language. 

TrainGroup 

Property 

Lets you train an entire group; although 
DragonDictate doesn’t strictly require 
training, it can improve accuracy. 

WordSelection 

Property 

Sets which words in a group get training in 
response to a TrainGroup command. 

TrainWord 

Property 

Lets you train a single word (see 

TrainGroup). 

Voicebarheight 

Property 

Sets the height of the voice bar (the pop 
up window that DragonDictate uses to 
interact with users). 

VoicebarLeft 

Property 

Left side of the voice bar. 

VoicebarTop 

Property 

Location of the top of the voice bar. 

VoicebarWidth 

Property 

Width of voice bar. 

AddGroup 

Method 

Adds a new group. 

DeleteGroup 

Method 

Deletes a group. 

FindGroup 

Method 

Determines if a group exists. 

AddVocabulary 

Method 

Adds a new vocabulary. 

DeleteVocabulary 

Method 

Deletes a vocabulary. 

Find Vocabulary 

Method 

Determines if a vocabulary exists. 

AddWord 

Method 

Adds a new word and associates a macro 
with it. 

DeleteWord 

Method 

Deletes a word. 

FindWord 

Method 

Determines if a word exists. 

Listen 

Method 

Temporarily adds a group to the list of 
active groups. 

GetLastErrorCode 

Method 

Returns last error code. 

IsDDWinRunning 

Method 

Returns True if DragonDictate is running. 

StartDDWin 

Method 

Start DragonDictate. 

CloseDDWin 

Method 

Shuts down DragonDictate. 


Table 1: DDSpeech control members. 
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If Not IsDDWinRunning() Then ‘ Dragon not running 
If Not StartDDWinQ Then ‘ Didn't start up either 
MsgBox “Can’t start DragonDictate” 

End If 
End If 


Example 1: Starting up DragonDictate. 


appropriate word. Also, when the Name 
field has the focus, the program auto¬ 
matically places Dragon in dictation mode. 
It is impressive how many common names 
Dragon correctly interprets. 

Saying “number” (or clicking the but¬ 
ton with that name) brings up an input 
box. From here you can just say numbers 
aloud to dial them. Say “okay” when you 
are done, or “cancel” to abort. Dialing the 
phone is easy with an MSCOMM ActiveX 
control. The dialer assumes you have a 
Hayes-compatible modem on COM1 (al¬ 
though that’s easy to change). 

Implementation 

The trick to this program is setting up word 
recognition. When you add a new name, 
the program constructs a string to “teach” 
Dragon. The string consists of the name, a 
tab character, and the phone number. How¬ 
ever, this would be awkward to pronounce, 
so the program also adds a square brack¬ 
et, the name alone, and closing bracket. By 
placing alternate text in brackets, you are 
telling Dragon that the text between the 
brackets is the correct pronunciation for 
the preceding word. The program then 
feeds this string to the AddWord method 
of the speech control. If Dragon can’t de¬ 
duce a speech model for the word, Add- 
Word returns False and the program lets 
the user train the word in question. Listing 
One (listing begins on page 98) includes 
this logic (see the Add_Click subroutine). 

Interestingly, the listbox holds names in 
the same format (but no pronunciation in 
square brackets). This makes it easy to cre¬ 
ate a single Dial routine that handles a string 
from the voice recognition or listbox. It also 
makes it easy to reconstruct the listbox from 
the vocabulary data on startup (see the 
Form_Load subroutine in Listing One). 

The DDSpeechl_SpeechRecognized rou¬ 
tine handles the voice dialing. The only rea¬ 
son there is more than one line of code in 
this routine is that I wanted to change the 
listbox selection to reflect the dialed num¬ 
ber. Visual feedback is important when you 
are dealing with voice command, because 
voice is not 100 percent accurate. When you 
delete a name, for example, the program is 
careful to prompt you before taking action. 
It might be a good idea to add a similar safe¬ 
guard to the dialing routine, too. 

The form used to add names is avail¬ 
able online. There, you can find the code 
that sets Dragon’s mode when each text 



Figure 1: The voice dialer application. 

box receives the focus. This allows users 
to dictate names without having to ex¬ 
plicitly set the dictation mode. 

Other Possibilities 

Once you have the ability to work with 
voice commands and dictation, there are 
many other ways you can make your ap¬ 
plication more voice friendly. For exam¬ 
ple, by using the SetHomeGroup script 
command, you could restrict the phone- 
number fields to accept only words that 
make sense for phone numbers. You can 
also use DgnTTS control to convert words 
back to voice (although for simple uses, 
you might be better off just playing pre¬ 
recorded wave files). 

Although DragonXTools has some prob¬ 
lems (poor NT compatibility and difficult 
to manage sleep mode), it is exciting to 
watch a program respond to spoken words. 
Probably the biggest disadvantage is that 
users have to already have one of the Drag¬ 
on products that provide the actual speech 
processing. Of course, if you are building 
a dedicated system, or you are willing to 
license the product from Dragon, this may 
not be a problem. Just try to resist the urge 
to speak into your mouse. 


For More Information 

Dragon Systems Inc. 

320 Nevada Street 
Newton, MA 02160 
617-963-5200 

http://www. dragonsystems.com/ 


DDJ 

(listing begins on page 98.) 


Need a 
Modern 

Parsing 

Tool?? 


& £« Xie» BAs .. 

rudest * & ■SjSV*** 





r?' String, ‘string 1 , 

! UnknounAttrParn unknounAttr -> UfflWOWNPAW! 1 

|( . 

I ET - 

Natural Language Parsing! 


New! Version 3.0 




Visual Parse++ is the only tool that brings 
cutting edge parsing technology to all 
developer’s. You can design any parser 
without ever leaving our sophisticated 
visual development environment. 
Whether you’re new to parsing 
technology, or an experienced veteran, 
Visual Parse++ is the right tool for you. 

Visual Parse++ provides native pro¬ 
gramming support for C, C++, Java, 
Visual Basic, and Delphi. Our C++ and 
Java classes are fully supported on all 
platforms. Visual Parse++ also comes 
with drop-in parsers for HTML, SQL, 
RTF, Java, C, C++, and more. 

New to version 3.0 is natural language 
parsing. Visual Parse++ is easily the 
most powerful parsing engine in the 
world with generalized parsing 
capability. Visual Parse++ now can 
handle any grammar, including 
ambiguous grammars. This opens up the 
area of natural language parsing, 
among other applications. Also included 
is a brand new user interface, with many 
new features and improvements, along 
with 3D parse tree and machine views. 


lava | C++1 Delphi | ActiveX I VB 


Order a copy today! 

Call 800-988-9023 
www.sand-sione.com 

Sandstone Technology 



939 Coast Blvd 
Suite 4C 

La Jolla, CA 92037 
Phone: 619)454-9404 
Fax: (619)4-54-9467 
willd@sand-stone.com 
www.sand-stone.com 


Dr Dobb’s Journal, July 1998 


89 




























































PROGRAMMER'S TOOLCHEST 



JDBC Drivers and Web Security 

Security and success go hand-in-hand 


Mukul Sood 


T he Java Database Connectivity (JDBC) 
specification is an interface for 
database programming. At present, 
there are at least two dozen com¬ 
mercially available JDBC implementations. 
As I described in “Examining JCBC 
Drivers” (DDJ, January 1998), JDBC driv¬ 
er vendors have considerable freedom in 
their implementations of the JDBC speci¬ 
fication. Still, to be JDBC compliant, JDBC 
drivers must support the ANSI SQL 2 En¬ 
try Level standard, pass JavaSoft confor¬ 
mance tests, and fall into one of four cat¬ 
egories as defined by JavaSoft: 

• Type I, JDBC/ODBC Bridge. 

• Type II, Native-API, Partly Java Driver. 

• Type III, Net-Protocol, All Java Driver. 

• Type IV, Native-Protocol, All Java Driver. 

I won’t detail the differences between 
these four categories, referring you instead 
to my January 1998 article. In this article, 
I’ll focus on the security features offered 
by various driver vendors, and describe 
how they fit in with the various applica¬ 
tion deployment architectures. 

Java, Security, and the Web 

Although security is not officially part of 
the JDBC specification, it is nonetheless 
critical for many database applications de¬ 
ployed on the Web. The success of on¬ 
line trading, shopping marts, and sensi¬ 
tive retail transfer information (credit cards, 
bank accounts, social-security numbers, 
and the like) over an inherently insecure 
medium (the Internet) depends on reli¬ 
able security. Consequently, JDBC driver 
vendors are beginning to offer security 
features such as encryption and authenti¬ 
cation, which can be used by applications 
to deliver secure and reliable services. 


Mukul is a system architect at Digital 
Focus. He can be contacted at mukuls@ 
digitalfocus. com. 


Applications can be deployed on the 

web in various configurations. 

• Client behind a firewall. Firewall securi¬ 
ty is an integral part of security infra- 
staicture at many organizations. This es¬ 
pecially holds true if the organization 
allows Internet access. Typically, orga¬ 
nizations put a firewall between the pri¬ 
vate taisted network and the public In¬ 
ternet. In this case, access would be 
allowed only to certain protocols (HTTP) 
and at a specific port. Thus a client be¬ 
hind a firewall would be able to con¬ 
nect through the firewall, if it uses these 
allowed protocols. Figure 1 shows this 
configuration. If the JDBC client speaks 
a certain protocol, it would be able to 
connect to the web-server host only if 
it supports tunneling of that protocol 
through HTTP packets, assuming the 
firewall on the client allows HTTP traf¬ 
fic to get through; Sybase’s jConnect, for 
example, uses Tabular Data Stream for¬ 
mat (TDS). (For more on Java and se¬ 
cure tunneling, see “Java Q&A,” by Ken¬ 
neth Golomb and Thomas Sorgie, DDJ, 
June 1998.) The other possibility would 
be for the client-side firewall to allow 
the protocol (TDS, SqlNet, and so on) 
to get through. 

• Client outside of a firewall. Another com¬ 
monly used configuration; the client ac¬ 
cesses the Internet without going 
through a firewall. In this case, the client 
can use vendor-specific protocols to 
connect to the server host. The server 
could be running on the same host as 
the web server that served the applet or 
it could be on a different host. The serv¬ 
er could be a gateway server (in case 
of Type IV drivers) or a JDBC server (in 
case of Type III drivers). The JDBC serv¬ 
er could be set up on a host different 
from the web server, in which case it 
would be necessary to run a proxy serv¬ 
er on the web-server host. This proxy 


would pass through JDBC client requests 
to the JDBC server and response from 
the server to the client; see Figure 2. 

• Client in an intranet. A private trusted 
network would have no firewalls in¬ 
stalled. Examples would be department- 
or company-wide intranets that are 
sealed off from public networks (such 
as Internet). In this configuration, the 
client would connect to the web-server 
host, which also runs the gateway serv¬ 
er for Type IV drivers, the proxy serv¬ 
er for Type III drivers, or runs the JDBC 
server for Type III drivers. 

The role of a gateway for a Type IV 
driver is different from that for a Type 
III driver. A gateway for a Type IV driv¬ 
er is actually a connection server that 
manages database connections. In case 
of a Type III driver, the gateway is ba¬ 
sically a proxy for the actual connection 
server. A Type IV driver can only con¬ 
nect to the web server from which it 
was downloaded so it can open a 
database connection to the web-server 
host. Consequently, the database serv¬ 
er would need to be installed on the 
same host as the web server. The gate¬ 
way gets around this limitation by tak¬ 
ing the role of a connection server. 

These are some common deployment 
configurations. Many configurations are 
possible, given existing infrastrucure, ap¬ 
plication requirements, IT standards em¬ 
ployed by the organization, and other 
factors. 

The Secure Sockets Layer Protocol 

Encryption and authentication are integral 
parts of security, and the Secure Sockets 
Layer (SSL) protocol supports both of these 
features. SSL is the dominant protocol for 
encrypting general communications be¬ 
tween browsers and servers. It is built into 
both the Netscape and Microsoft browsers. 
The SSL protocol operates at the TCP/IP 
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(continued from page 90) 
transport layer, one level below application- 
specific protocols such as NNTP (news), 
HTTP (web), and SMTP (mail). Any pro¬ 
gram that uses TCP can be modified to 
use secure SSL connections by making a 
few source code changes. Figure 3 shows 
the SSL protocol stack. 

The main trade-off for putting SSL at the 
transport layer is that it is not specifically 
tuned for HTTP and therefore may not al¬ 
ways be efficient for web browsing. A mi¬ 
nor limitation is that an SSL connection 
must use a dedicated TCP/IP socket. SSL 
uses cryptographic principles such as dig¬ 
ital envelope, signed certificates, and mes¬ 
sage digests. An important feature of SSL 


is flexibility with regard to choices of en¬ 
cryption algorithm (symmetric algorithms 
like DES, 3DES, RC2, RC4), message di¬ 
gests (MD5, SHA), and authentication 
methods (RSA public keys and certificates 
or Diffie-Hellman key exchange). 

The combination of encryption algo¬ 
rithm, message-digest function, and au¬ 
thentication is known as a “cipher suite.” 
The Netscape browser supports more than 
30 cipher suites. Likewise, JDBC drivers 
support various cipher suites. 

When an SSL client first makes contact 
with a server, the two negotiate a com¬ 
mon cipher suite. In general, the two try 
to pick the strongest encryption methods 
that they have in common. 


When an SSL connection is in place, all 
browser-to-server and server-to-browser 
communications are encrypted including 
the URL of the requested document, con¬ 
tents of the requested document, and con¬ 
tents of the HTTP header. 

Table 1 summarizes the drivers and 
shows what features are offered by each 
vendor. 

Tengah/JDBC 

Weblogic’s Tengah/JDBC is a Type III im¬ 
plementation of JDBC for use with Java 
applets and applications. It includes fea¬ 
tures such as authentication and encryp¬ 
tion (through Tengah SSL), access to name 
services (NIS, NDS, and the like), access- 
control lists, HTTP, HOP tunneling, and 
proxy support. 

Tengah/JDBC secures networked appli¬ 
cations with optional encryption, authen¬ 
tication, and authorization based on RSA 
SSL, X.509 certificates, and access-control 
lists. It provides encryption and authenti¬ 
cation through Tengah SSL, which is Web¬ 
logic’s implementation of SSL Version 3. 
Tengah SSL uses RSA as the key exchange 
method. It supports both server-to-client 
and two-way authentication. User au¬ 
thentication is provided through X.509 cer¬ 
tificates. Tengah supports message proto¬ 
cols such as t3 (Tengah’s native protocol, 
which uses TCP sockets) and HTTP. The 
SSL layer permits these protocols to be se¬ 
cured as t3s and HTTPS. When a t3s con¬ 
nection is opened, a certificate exchange 
occurs that guarantees the server’s identi¬ 
ty. Thereafter, communications are en¬ 
crypted. In the case of an applet, the cer¬ 
tificate used to establish the HTTPS 
connection is used for die applet’s t3s con¬ 
nection. 

Tengah uses the Java Naming and Di¬ 
rectory Interface (JNDI) to provide access 
to underlying directory-naming services 
that support LDAP, such as Novell’s NDS 
and Sun’s NIS. 

It uses the JDK 1.1 ACL Principal, 
Group, Permission, Acl, and AclEntry in¬ 
terfaces in its implementation of ACL. Ten¬ 
gah’s support for ACLs follows the Java- 
soft javasecurity.acl specification. The ACL 
support built into Tengah, the Weblogic 
Realm, depends upon users having an en¬ 
try in a list that grants or denies permis¬ 
sion to access a particular service. Tengah 
organizes Users, Groups, Permissions, and 
Acls into Realms which map to Principal, 
Group, Permission, Acl, and AclEntry. A 
Tengah application can set up its own 
ACL, and its own Realm. The Weblogic 
Realm, which is supplied as a Tengah ser¬ 
vice, provides ACLs for Tengah. 

Tengah also supports HTTP and HOP 
tunneling; thus, a client behind a firewall 
could connect to the Tengah server through 
these tunneling mechanisms. 



Figure 1: Java client behind a firewall accessing database through a Type III 
JDBC driver 



Figure 2: Java client outside of a firewall accessing databases through a Type 
III JDBC driver. 
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Product 

Vendor Version 

Driver 

Type 

Encryption 

Authentication 

SSL 

Support 

ACL 

Proxy 

Support 

HTTP 

Tunneling 

Tengah 

Weblogic 

3.0 

3 

Yes 

Yes 

Yes 

Yes 

Yes 

Yes 

SequeLink 

Intersolv 

3.5 

3 

Yes 

Yes 

No 

Yes 

Yes 

No 

JSQL/Ingres 

Caribou Lake Sw 


3 

Yes 

Yes 

No 

Yes 

Yes 

Yes 

SqlRetriever 

SCO 


3 

No 

Yes 

No 

Yes 

Yes 

No 

jConnect 

Sybase 

3.0 

4 

Yes 

Yes 

Yes 

NA 

Yes 

Yes 

Oracle Driver 

Oracle 

1.0 

4 

No 

No 

No 

NA 

Yes 

No 

Fast Forward 

Connect Software 

3.0 

4 

Yes 

Yes 

No 

NA 

Yes 

Yes 

OPENjdbc 

1-Kinetics 


3 

Yes 

Yes 

Yes 

Yes 

Yes 

0 


Table 1: Security features offered by various JDBC drivers 


SequeLink 

SequeLink, Intersolv’s Type III driver, pro¬ 
vides features such as multiple levels of 
security, encryption, and a lightweight Java 
proxy. 

SequeLink supports six levels of secu¬ 
rity: DBMS system authentication, host sys¬ 
tem authentication, data encryption, ap¬ 
plication authentication, Readonly, and 
Autocommit. 

SequeLink interfaces with the host sys¬ 
tem security provided by the OS system 
security (Windows NT or UNIX, for in¬ 
stance), delivering an additional layer of 
user authentication for access to the sys¬ 
tem services. SequeLink does not support 
JNDI in the current version. SequeLink 
uses encryption on-the-wire for all data 
and user account information (including 
UID/PWD). The current version does not 
use SSL. Application authentication allows 
system administrators to determine spe¬ 
cific client applications that can access spe¬ 
cific SequeLink services. Client applica¬ 
tions pass a specific key that the 
SequeLink server then validates as an au¬ 
thenticated server configuration. Certain 
apps (query tools) can thus be restricted 
to read-only while others can have full 
write and update permissions. 

SequeLink offers the unique Readonly 
and Autocommit filters. When Autocommit 


is switched on, the server begins and com¬ 
mits each statement immediately, regardless 
of application setting. When Readonly is 
switched, the server processes only SQL 
SELECT statements and does not send state¬ 
ments such as INSERT, UPDATE, and 
DELETE to the database engine. This fea¬ 
ture can be useful for organizations where 
custom applications are used for order en¬ 
try (requiring end users to have write per¬ 
missions), but the same end users may need 
to run query tools for decision support or 
data mining. If a user were to accidentally 
change a value in these other tools, then 
the entire data could be corrupted. 

Another SequeLink feature is its Java 
proxy, which is essentially a Java appli¬ 
cation running on the web-server host, its 
role being that of a pass-through server 
to the SequeLink JDBC server. 


SequeLink does not have HTTP tun¬ 
neling support in its current version. Clients 
behind a firewall that allows only HTTP 
traffic, therefore, would not be able to 
connect to the server. 

JSQL/Ing res 

JSQL (Java to SQL) is a Type III driver 
from Caribou Lake Software for connect¬ 
ing to Ingres databases. It has various com¬ 
ponents that provide proxy services, au¬ 
thentication, tunneling, and the main server 
component that connects to database 
servers. These components are: 

• Jsvr, a JDBC connection server. 

• Jpass, a proxy server for Jsvr. 

• Jtunnel, for HTTP tunneling. 

• Jauth, validates username/password on 
remote computers in network. 
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Figure 3: The SSL protocol stack. Figure 4: jConnect configuration for a client behind a firewall. 


Jtunnel is an HTTP tunneling server that 
tunnels JDBC connections through fire¬ 
walls and reverse proxy servers. Jtunnel 
could also be used with a secure HTTP 
server to provide encryption between the 
Java client and the web server. Jtunnel 
comes with a CGI script named “Jcgi” that 
should be installed on the web-server host 
if tunneling is required. This script takes 
the HTTP packet and sends it to Jtunnel, 
which retrieves the data from the packet 
and forwards it either to Jpass or to Jsvr 
depending on the connection URL in the 
request. Jpass provides pass-through ser¬ 
vices; Jsvr can be installed on a different 
host than the web server, and Jpass would 
relay client requests to Jsvr. 

Jauth is the authentication server for au¬ 
thenticating JDBC client connects to the 
Jsrv connection server. It supports au¬ 
thentication methods such as operating- 
system authentication (for server OSes), 
database authentication (Open Ingres 
only), and remote authentication (server 
OSes). Jsvr can be configured with an 
access-control list. 

SQL Retriever 

SQL Retriever is SCO’s server module, with 
which the SCO JDBC client communicates. 
The JDBC client allows Java applets or ap¬ 
plications to access information from Or¬ 
acle, Informix, Ingres, Sybase, Interbase, 
and Progress databases on any UNIX plat¬ 
form. 

The driver communicates with the serv¬ 
er module, which is installed either on the 
web server or another host. The driver 
communicates with the server using Sun 
RPC (Remote Procedure Call) mechanism. 
The RPC layer forms a connection using 
Java sockets. The SQL-Retriever server is 
a UNIX daemon process. The default con¬ 
figuration for JDBC client and server is that 


the client gets the port of the server from 
portmapper and the server is started as 
root and registers itself with the portmap¬ 
per. If the server is behind a firewall, the 
port 111 (used by portmapper) is blocked. 
In this case, the server can be made to lis¬ 
ten on a specific port (start the server with 
a -1 flag, flag should be followed by the 
port number). At the client side, the port 
should be specified in the JDBC connect 
URL, the client then will not use the 
portmapper, it will go straight to this port. 
If the client is behind a firewall which al¬ 
lows only HTTP traffic, then the client would 
not be able to connect to the server. 

SQL Retriever’s security features include 
a security manager which lets system ad¬ 
ministrators control user access to the 
database or to specific tables in the 
database, and a proxy RPC-Reflector, 
which allows servers to be installed on a 
host other than a web server (it passes 
through client requests to the server). SQL 
Retriever does not offer encryption and 
server-authentication. 

jConnect 

Sybase’s jConnect is a Type IV driver for 
connecting to the Sybase SQL Server. For 
connecting to servers using SSL, jConnect 
Release 3.0 provides a Java servlet that 
should be installed on the web server that 
hosts the applet. The web server should 
support the javax.servlet interfaces, which 
enables jConnect to support encryption 
using the web server as the gateway. jCon¬ 
nect uses the TDS-tunnelled HTTP pro¬ 
tocol in proxy and firewall configurations; 
see Figure 4. 

With the TDS-tunneling servlet, requests 
from a client to the back-end server that 
go through the gateway include a GET or 
POST command, the TDS session ID (af¬ 
ter the initial request), back-end address, 


and status of the request as query pa¬ 
rameters for the request. The TDS stream 
is contained in the body of the request. 
Two header fields indicate the length of 
the TDS stream included in the request 
packet, and the session ID assigned by 
the servlet. When the client sends in an 
initial request (login request), the servlet 
creates a session ID, strips the HTTP head¬ 
ers and sends the TDS data to the server, 
gets the results back from the server in 
TDS format, assembles an HTTP packet 
(passing the session ID in the header), 
and sends the packet to the client. Sub¬ 
sequent requests from the client contain 
that session ID in the header. 

Oracle ThinJDBC 

ThinJDBC, Oracle’s Type IV driver, has a 
footprint of about 150 KB and provides 
its own implementation of a TCP/IP ver¬ 
sion of Oracle’s SQLNet/Net8 protocol. 
This driver only works with TCP/IP-based 
networks. It supports Oracle databases 
Versions 7.2 and upward. ThinJDBC does 
not have proxy support; it can, however, 
be used with the Oracle Connection man¬ 
ager to achieve three-tier configurations. 
Since it does not support HTTP tunnel¬ 
ing, it will not work with those firewalls 
that only allow HTTP through. It would 
work with firewalls that allow SQLNet traf¬ 
fic. The communication between an ap¬ 
plet that uses the ThinJDBC driver and the 
database happens over Java TCP/IP sock¬ 
ets. The connection can only be made if 
the web browser (where the applet is ex¬ 
ecuting) allows a socket connection to be 
made. In JDK 1.0.2-based browsers (such 
as Netscape 3.0), the applet would only 
be able to open a connection to the host 
from which it was downloaded. In this 
case, the database would have to be pre¬ 
sent on the same host as the web server. 
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INTERNET PROGRAMMING 


Listing One 

(a) 

Otype cfsl.xsl 

<!— Ultra simple XSL stylesheet —> 

<xsl> 

<rule> 

<!— Pattern —> 

<root/> 

<!— Action —> 

<HTML> 

<HEAD> 

<TITLE>Cars for sale - Example 1</TITLE> 

</HEAD> 

<BODY> 

<children/> 

</B0DY> 

</HTML> 

</rule> 

</xsl> 

(b) 

Omsxsl -i cfs.xml -s cfsl.xsl -o cfsl.htm 

Otype cfsl.htm 

<HTML> 

<HEAD> 

<TITLE>Cars for sale - Example 1</TITLE> 

</HEAD> 

<B0DY> 

ToyotaRedFordWhite 

</B0DY> 

</HTML> 

Listing Two 

(a) 

<!— Process Car elements by processing all children and then adding 
a horizontal rule —> 

<rule> 

<!— Pattern —> 

<target-element type = "Car"/> 

<!— Action —> 

<children/> 

<HR/> 

</rule> 

<!— Process Maker elements by prefixing some literal text and then 
processing all children —> 

<rule> 

<!— Pattern —> 

<target-element type = "Maker"/> 

<!— Action —> 

<P> 

Make of Car: <children/> 

</P> 

</rule> 

<!— Process both Condition and Color elements in the same way—simply 
create HTML paragraphs —> 

<rule> 

<!— Pattern —> 

<target-element type = "Condition"/> 

<target-element type = "Color"/> 

<!— Action —> 

<P> 

<children/> 

</P> 

</rule> 

(b) 

Omsxsl -i cfs.xml -s cfs2.xsl -o cfs2.htm 

Otype cfs2.htm 

<HTML> 

<HEAD> 

<TITLE>Cars for sale - Example 2</TITLE> 

</HEAD> 

<B0DY> 

<P> Make of Car: Toyota 
</PXP> 

</PXP> 

Red 

</PXHRXP> Make of Car: Ford 
</PXP> 

</PXP> 

White 

</PXHR> 

</BODY> 

</HTML> 

Listing Three 

(a) 

<rule> 

<target-element type = "Car"/> 

<P> 

Price = <eval><![CDATA[ 

getAttribute("Price") + " " + getAttribute("Units") 

]]></eval> 

</P> 

<children/> 

<HR/> 

</rule> 

(b) 

Omsxsl -i cfs.xml -s cfs3.xsl -o cfs3.htm 

Otype cfs3.htm 

<HTML> 

<HEAD> 

<TITLE>Cars for sale - Example 3</TITLE> 


</HEAD> 

<B0DY> 

<P> Price = 10000 Dollars 
</PXP> Make of Car: Toyota 
</PXP> 

</PXP> 

Red 

</PXHRXP> Price = 20000 Irish Punts 

</PXP> Make of Car: Ford 

</PXP> 

</PXP> 

White 

</PXHR> 

</BODY> 

</HTML> 

Listing Four 

(a) 

Otype cfs4.xsl 
<xsl> 

<rule> 

<!— Pattern —> 

<root/> 

<!— Action —> 

<HTML> 

<HEAD> 

<TITLE>Cars for sale - Example 4</TITLE> 

</HEAD> 

<BODY> 

<TABLE B0RDER="1"> 

<TR> 

<TD>Number</TD> 

<TD>Price</TD> 

<TD>Maker</TD> 

<TD>Condition</TD> 

<TD>Color</TD> 

</TR> 

<children/> 

</TABLE> 

</B0DY> 

</HTML> 

</rule> 

<rule> 

<!— Pattern —> 

<target-element type = "Car"/> 

<!— Action —> 

<TR> 

<!— Automatically number the table rows —> 

<TDXeval>childNumber (this) </eval></TD> 

(continued on page 98) 
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(continued from page 97) 

<eval>getAttribute("Price") + " " + getAttribute("Units")</eval> 

</TD> 

<children/> 

</TR> 

</rule> 

<rule> 

<!— Pattern —> 

Ctarget-element type = "Maker"/> 

<target-element type = "Color"/> 

< ! — Action -—> 

<TD> 

<children/> 

</TD> 

</rule> 

<rule> 

<!— Pattern —> 

Ctarget-element type = "Condition"/) 

<TD> 

<eval><![CDATA[ 
getAttribute("Type") 

]]></eval> 

</TD> 

</rule> 

</xsl> 

(b) 

Omsxsl -i cfs.xml -s cfs4.xsl -o cfs4.htm 

Otype cfs4.htm 

<HTML> 

<HEAD> 

<TITLE>Cars for sale - Example 4</TITLE> 

</HEAD> 

<B0DY> 

<TABLE B0RDER="1"> 

<TR> 

<TD>Number</TD><TD>Price</TDXTD>Maker</TDXTD>Condition</TD> 

<TD>Color</TDX/TR> 

<TRXTD>1</TDXTD> 10000 Dollars</TDXTD>Toyota</TDXTD>Good</TDXTD>Red</TD> 
</TR> 

<TRXTD>2</TDXTD>20000 Irish Punts</TDXTD>Ford</TDXTD>Good</TDXTD> 
White</TDX/TR> 

</TABLE) 

</B0DY> 

</HTML> 

Listing Five 

(a) 

Otype cfs5.xsl 
<xsl> 

<rule> 

<root/> 

<HTML> 

<HEAD) 

<TITLE)Cars for sale - Example 5</TITLE> 

</HEAD> 

<B0DY> 

<TABLE B0RDER="1"> 

<children/> 

</TABLE) 

</B0DY) 

</HTML) 

</rule> 

<rule> 

<target-element type = "Car"/) 

<TR> 

<select-elements) 

<target-element type = "Maker"/) 

</select-elements> 

</TR> 

</rule> 

<rule> 

<target-element type = "Maker"/) 

<TD> 

<children/> 

</TD> 

</rule> 

</xsl> 

(b) 

Omsxsl -i cfs.xml -s cfs5.xsl -o cfs5.htm 

Otype cfs5.htm 

<HTML> 

<HEAD> 

<TITLE)Cars for sale - Example 5</TITLE) 

</HEAD> 

<BODY> 

<TABLE B0RDER="1"> 

<TR> 

<TD> 

Toyota 

</TD> 

</TRXTR> 

<TD> 

Ford 

</TD> 

</TR> 

</TABLE) 

</B0DY> 

</HTML> 

Listing Six 

(a) 

Otype cfs8.xsl 
<xsl> 

<define-script><![CDATA[ 

// 1.5 Dollars to every Irish Pound 


var ExchangeRate = 1.5; 

// Convert price into Irish Pounds based on the ExchangeRate variable 
//if units is Dollars 

function getPricelnlrishPunts(price,units) 

( 

if (units == "Dollars") 

return price * ExchangeRate + " Irish Pounds"; 
else 

return price + " Irish Pounds"; 

} 

]]></define-script> 

<rule> 

<!— Pattern —> 

<root/> 

<!— Action —> 

<HTML> 

CHEAD) 

<TITLE)Cars for sale - Example 8</TITLE> 

</HEAD> 

<B0DY> 

<PXB> 

Note: Exchange Rate Used <eval)ExchangeRate+" Dollars per Irish Pound"</eval> 
</BX/P> 

<children/> 

</BODY> 

</HTML> 

</rule> 

<rule> 

<!— Pattern —> 

Ctarget-element type = "Car"/) 

<!— Action —> 

<P> 

Price in Irish Punts= CevalX! [CDATA[ 

getPricelnlrishPunts(getAttribute("Price").getAttribute("Units")) 

]]></eval> 

</P) 

Cchildren/) 

</rule> 

Crule) 

<!— Pattern —> 

Ctarget-element type = "Make"/) 

Ctarget-element type = "Color"/) 

C!— Action —> 

CP) 

Cchildren/) 

C/P) 

C/rule> 

C/xsl> 

(b) 

Omsxml -i cfs.xml -s cfs8.xsl -o cfs8.htm 

Otype cfs8.htm 

CHTML) 

CHEAD) 

CTITLE)Cars for sale - Example 8C/TITLE) 

C/HEAD) 

CBODY) 

CP)CB> Note : Exchange Rate Used 1.5 Dollars per Irish Pound 
C/BX/P) 

CP) Price in Irish Punts= 15000 Irish Pounds 
C/P)ToyotaCP> 

Red 

C/P)CP> Price in Irish Punts= 20000 Irish Pounds 
C/P)FordCP> 

White 

C/P) 

C/BODY) 

C/HTML) 


DRAGON 


Listing One 


VERSION 5.00 

Object = "CC9F1DD69-49F9-11D0-B5C5-444553540000}#1.0#0"; 
Object = "C648A5603-2C6E-101B-82B6-000000000014)#1.1#0"; 
Begin VB.Form MainForm 


Caption 

= 

"Voice Dialer" 

ClientHeight 

= 

3195 

ClientLeft 

= 

60 

ClientTop 

= 

345 

ClientWidth 

= 

4680 

LinkTopic 

= 

"Forml" 

ScaleHeight 

= 

3195 

ScaleWidth 

= 

4680 

StartUpPosition 

= 

3 'Windows Default 

Begin VB.CommandButton ManDial 

Caption 


= "Number" 

Height 


= 495 

Left 


= 120 

TabIndex 


= 3 

Top 


= 1560 

Width 


= 975 


End 


Begin MSCommLib.MSComm 
Left 

Top = 
_ExtentX = 
.ExtentY = 
.Version = 
DTREnable = 


MSComml 

720 

2520 

1005 

1005 

327680 

0 'False 


End 

Begin VB.CommandButton Delete 
Caption = "Remove" 

Height = 495 

Left = 120 


"dd32.ocx" 
"MSCOMM32.OCX" 
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Tablndex = 2 

Top = 840 

Width = 975 

End 

Begin VB.CommandButton Add 
Caption = "Add" 


Height 

= 

495 

Left 

= 

120 

Tablndex 

= 

1 

Top 

= 

120 

Width 

= 

975 

End 

Begin VB.ListBox 

Listl 


Height 

= 

2790 

Left 

= 

1320 

Sorted 

= 

-1 'True 

Tablndex 

= 

0 

Top 

= 

120 

Width 

= 

3135 

End 

Begin DDSpeechLib.DDSpeech DDSpeechl 

Left 

= 

120 

Top 

= 

2640 

.Version 

= 

65536 

_ExtentX 

= 

741 

_ExtentY 

= 

741 

_StockProps 

= 

0 


End 

End 

Attribute VB.Name = "MainForm" 

Attribute VB_GlobalNameSpace = False 
Attribute VB_Creatable = False 
Attribute VB_PredeclaredId = True 
Attribute VB_Exposed = False 
Option Explicit 

Private Sub Add_Click() 

' Name, number, and generic string 

Dim n As String, nm As String, s As String, word As String 
AddForm.Show vbModal 
If AddForm.Cancelled <> True Then 
n = AddForm.NewName 
nm = AddForm.NewNumber 
s = n & Chr(9) & nm 
Listl.Addltem s 
word = s & "[" & n & "]" 

If DDSpeechl.AddWord("PhBook", "TelNum", word, "'") 

= EXP_ERR_WORD_HAS _N0_M0DEL Then 

DDSpeechl.TrainWord = word 
End If 

Unload AddForm 
End If 
End Sub 

' Dial a number in the format of name (tab) number [xxx] 

' The brackets, if present at all, are ignored 
Sub Dial(ByVal word As String) 

Dim n As Integer 
Dim t0 As Date 

Dim dn As String, nam As String ' Dial number, name 

n = InStr(word, Chr(9)) 

dn = Right(word, Len(word) - n) 

nam = Left(word, n - 1) 

n = InStr(dn, "[") 

If n <> 0 Then dn = Left(dn, n - 1) 

MSComml.PortOpen = True 

MSComml.Output = "ATV1E0DT" & dn & Chr(13) 

t0 = DateAddC's", 5, Now) 

Do 

DoEvents 

Loop Until Now > t0 ' Wait 5 seconds 
MSComml.PortOpen = False 
MsgBox dn, vbOKOnly, "Dialed " & nam 
End Sub 

'Delete Entry 

Private Sub Delete_Click() 

Dim n As Integer 

Dim word As String, nam As String 
n = Listl.Listlndex 
If n <> -1 Then 

If MsgBox("Delete this entry", vbYesNo) = vbNo Then Exit Sub 
word = Listl.Text 

nam = Left(word, InStr(word, Chr(9)) - 1) 
word = word & "[" & nam & "]" 

' Delete word from dragon dictionary 
If DDSpeechl.DeleteWord("PhBook", "TelNum", word) Then 
Listl.Removeltem n 
Else 

MsgBox "Can't remove name" 

End If 
Else 

MsgBox "Please select a name first" 

End If 
End Sub 

' Manual dial a number 
Private Sub ManDial_Click() 

Dim nr As String 

nr = InputBox("Enter or say the number to dial") 

If nr <> "" Then Dial ("Manual Dial" & Chr(9) & nr) 

End Sub 

Private Sub DDSpeechl_SpeechRecognized(word As String, WordValue As String) 
Dim SearchWord As String 
Dim i As Integer 

' Find string in listbox so we can highlight it 
SearchWord = Left(word, InStr(word, "[") - 1) 

Listl.Listlndex = -1 

For i = 0 To Listl.ListCount - 1 


If SearchWord = Listl.List(i) Then 
Listl.Listlndex = i 
Exit For 
End If 
Next i 

Dial word ' Do it 
End Sub 

Private Sub Form_Load() 

Dim s As String 
Dim n As Integer 

' Start Dragon if not already started 
If Not IsDDWinRunningQ Then 
If Not StartDDWinO Then 

MsgBox "Can't start Dragon Dictate", vbExclamation 
End 

End If 
End If 

DDSpeechl.Attach = True 
DDSpeechl.AddVocabulary "PhBook" 

DDSpeechl.AddGroup "PhBook", "TelNum" 

DDSpeechl.Vocabulary = "PhBook" 

DDSpeechl.Group = "TelNum" 

' Load phone numbers already in vocabulary 
s = DDSpeechl.WordFirst 
Do While s <> "" 
n = InStr(s, "[") 

Listl.Addltem (Left(s, n - 1)) 
s = DDSpeechl.WordNext 
Loop 
End Sub 

' Double click for those who are speechless! 

Private Sub Listl_DblClick() 

Dial Listl.Text 
End Sub 

DDJ 
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PROGRAMMING PARADIGMS 


Leo and the Lizards 

Michael Swaine 



E mbarrassed at never having read 
Finnegan’s Wake , I recently tried to 
struggle through one of the many 
guides to James Jo yce' s dense mas¬ 
terpiece. All I got for my efforts, though, 
was a lamentable penchant for portman¬ 
teau words, as in the subhead below. A 
portmanteau word is an invented word 
constructed by compressing two or more 
words into the space reserved for one. 
“Thissue” compresses “this issue” and 
“calmtense” compresses “column con¬ 
tents,” as well as suggesting a portman¬ 
teau mood for this month’s column: 
calm/tense. You know: Relax and enjoy 
the roller-coaster ride. 

Tracking the ups and downs of com¬ 
puter technology, the paradigmatic un¬ 
dulations, the huckster hype and the cot¬ 
ton candy fluff of vaporware, has always 
felt to me like a day at the carnival. To 
lessen any vertigo induced by this col¬ 
umn’s roller-coaster ride, I’ve instituted 
the next section, a sort of table of con¬ 
tents for the column. Relax and read on. 

Thissue Calmtense 

• Last year all new product names sound¬ 
ed like Starbucks varieties. This year 
there’s a small but noisy flurry of new 
projects that sound like Japanese movie 
monsters. Mozilla, Cryptozilla, Scan- 
dizilla, Rhapzilla, Raptor. Netscape has 
let the lizards loose. 

• There’s this program called LEO. It com¬ 
bines Knuth-style Literate Programming 
with outlines a la Baron. Could an old 
Friend of Dobb’s have improved on 
Knuth? 

• Wasn’t the Fifth Generation Project a pop 
group back in the 70s? Not exactly. 

• Quantum computing wakes up in 
chlorophyll. 

• There’s this computer called Leo. It may 
have been the first business computer. 
• In Paradigms Past: Who actually in¬ 
vented the calculator? Please tell me he 
wasn’t called Leo. 

Land of the Lizards 

This spring, Netscape did what it had 
promised and made the source code avail¬ 
able for its Communicator product, invit¬ 
ing the entire software-development com- 


Michael is editor-at-large for DDJ. He can 
be contacted at mswaine@swaine.com. 


munity to join in the process of develop¬ 
ing the next version of Communicator, 
and, not incidentally, any products of their 
own they’d like to spin off. Within two 
weeks, 100,000 people had downloaded 
the code. 

Some of the code was missing, for the 
very good reason that Netscape didn’t con¬ 
trol the copyright on software it had li¬ 
censed from others. Some was missing for 
a dumb reason: the U.S. government pol¬ 
icy on encryption software. Within seven 
hours, the missing crypto had been re¬ 
placed, and the U.S. government made a 
monkey of, by Australian programmers. 

Days later, James Clark, the technical 
lead on the World Wide Web Consortium’s 
XML working group, (no relation to 
Netscape cofounder Jim Clark) added his 
XML parser to the Mozilla code base, and 
Netscape released the source for JavaScript 
1.3. And so on. Collaborative program¬ 
ming was off and running. 

Netscape likes to call this Open Source 
software. But Netscape didn’t invent it 
(and, to be fair, doesn’t pretend other¬ 
wise). It was called Free Software when 
Richard Stallman seemed to be all alone 
out there promoting the spirit of sharing 
what he learned at MIT in the ’60s. Stall¬ 
man’s crusade always seemed noble but 
quixotic. Sure, it would be a nicer world 
if everyone shared their programming dis¬ 
coveries with their programming peers. 
Sure, technology would progress more 
rapidly if programmers didn’t have to in¬ 
vent the virtual wheel every day because 
some earlier wheel inventor had locked 
up the plans. Sure, we’d all stand taller if 
we could stand on the shoulders of gi¬ 
ants. But software development is (often) 
a business, and intellectual property has 
dollar value. 

And so Stallman and the GNU heroes 
labored almost unknown. Until the Web 
arrived. 

Maybe it was just because the suits 
hadn’t figured out yet how to make mon¬ 
ey on the Web, maybe it was because the 
Web got its start among academics, but 
for some reason the tools of choice among 
webmasters were often free tools. Linux, 
Perl, Apache. The Apache Web server’s 
name even suggested the collaborative de¬ 
velopment process that Netscape is en¬ 
couraging— a patchy construction, a quilt. 
And Netscape’s cofounder was both savvy 


enough to understand the virtues of the 
approach and gutsy enough to push his 
company to put on a quilting bee. 

Now, thanks to Netscape and Marc An¬ 
dreessen, the Free Software/Open Source 
movement has momentum. Let’s hope it 
continues. One place to watch or join the 
movement is http://www.mozilla.org/, but 
there’s also http://www.opensource.org/. 

The Tangled WEB 

I have recently been looking at a source 
code editor whose author provides the 
source code with the product. Although 
I think that Ed planned to release the 
source for LEO long before Netscape did 
ditto for Communicator. 

LEO was inspired by Donald Knuth’s 
model of literate programming. Its inven¬ 
tor, Ed Ream, who also invented RED 
(which long-time DDJ readers will recog¬ 
nize as a text editor published in DDJ 
some 15 years ago), has been fiddling with 
literate programming for over a decade, 
but it never quite worked for him. 

Literate programming came onto the 
scene about the time Ed wrote RED. Knuth 
published the first paper on literate pro¬ 
gramming, and the language-plus-programs 
that embodied it, back in 1984. Looking 
for a three-letter English word that hadn’t 
already been applied to computers, Knuth 
decided to call his literate programming 
system WEB. (Later CWEB, but I’ll use the 
earlier term as a generic here.) 

When you write a program in WEB, you 
break your code down into sections, and 
these sections, written in C or Pascal or 
whatever plus WEB syntax, serve as the 
source code for two different WEB rou¬ 
tines. One produces documentation that 
describes the program clearly and facili¬ 
tates debugging. Its output goes to a text¬ 
formatting program such as Knuth’s own 
TEX. The other produces the machine- 
executable code, which serves as input to 
a compiler or interpreter. Since the same 
source generates both the documentation 
and the executable code, they are sure to 
be consistent with one another. The best 
introduction to literate programming is the 
book of the same title, by Donald E. Knuth 
(CSLI Lecture Notes No. 27 ’, 1992; ISBN 0- 
937073-80-6). 

Ed’s problem with WEB was that it was 
too hard to know when to create new sec¬ 
tions and to keep track of all the sections 
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Paradigms Past 

I t seems like a simple question: Who 
invented the calculator? But ques¬ 
tions of paternity are often tricky. Ac¬ 
cording to the U.S. Patent Office, the 
inventor was a bank clerk in St. Louis 
named William Seward Burroughs, in 
1886. Burroughs, the namesake and 
ancestor of beat author William S. Bur¬ 
roughs, built both a calculator and a 
company to sell it (American Arith¬ 
mometer Company, later Burroughs 
Adding Machine Co.). 

But Burroughs was beaten to the 
punch (by fully 66 years) by one 
Charles Xavier Thomas, Thomas of 
Colmar to his friends, who built the 
first commercial mass-produced cal¬ 
culator in 1820. It could add, subtract, 
and multiply, and, if you helped it a 
little, even divide. It took up most of 
a desktop, and continued to be sold 
for 90 years. 

Tom had got the idea, though, from 
a 17th century invention of Gottfried 
Wilhelm von Leibniz. Leibniz’s 
Stepped Reckoner was definitely a 
calculator: It added, subtracted, and 
did multiplication by repeated addi¬ 
tion and shifting. Although Leibniz 
was an early booster of the binary 
system, his machine was decimal. 

But Leibniz wasn’t first: Three years 
before he even planned his machine, 
a Brit named Samuel Morland had built 
a machine for toting up (decidedly 
nondecimal) British currency. 

Was Morland the first? Nope. Both 
he and Leibniz had merely expanded 
on an invention of Blaise Pascal. The 
Pascaline, built in 1642 for Pascal’s tax- 
collector dad, was (aha!) the first dig¬ 
ital adding machine (and the first dig¬ 
ital business machine). Pascal sold 
about a dozen of them. But the story 
doesn’t end there. Still earlier, in 1624, 
a fellow named Schickard had built a 
Calculating Clock that could add and 
subtract. If you really needed to mul¬ 
tiply, you could use the slide rule af¬ 
fixed to the front. 

And even earlier, sometime in the 
1500s, an artist drew some (recently 
discovered) sketches for a mechanical 
device that would add and subtract 
numbers. When a machine was built 
based on these sketches, it actually 
worked. 

The name of this artist, arguably the 
true inventor of the calculator, was 
Leonardo da Vinci. Another Leo. 

—M.S. 


once they were created. He now says that 
“flat literate programs have too little struc¬ 
ture.” His solution: Add outlines. 

There’s a devilish irony in Ed’s decision. 
One reason that Knuth chose the name 
WEB for his system was that he was com¬ 
ing to realize that programs are better un¬ 
derstood as webs than as hierarchical struc¬ 
tures. He wanted to get away from 
top-down, hierarchical programming mod¬ 
els. WEB was designed to allow program¬ 
mers to write top-down, bottom-up, some- 
of-each, or stream-of-consciousness, and 
still be able to convey to a human reader 
the relationships among the parts of the 
program. Ed put back the hierarchy, using 
More, the outliner from Userland written 
by Doug Baron et al., as his model. 

What we’re talking about here: An out¬ 
line consists of headlines that can be 
moved simply by dragging them. Each 
headline contains body text. Headlines de¬ 
fine the organization of the document; a 
parent outline can contain zero or more 
children. Children are indented from their 
parents. You can expand or contract head¬ 
lines simply by double-clicking near the 
headline. (Yes, double-clicking. Ed is cur¬ 
rently developing on a Mac, although his 
real target platform is Rhapsody.) Ed soon 
decided that outlines solved all his prob¬ 
lems with literate programming. Since then 
he’s been doing all his programming us¬ 
ing Leo and literate outlines, and says he’d 
never willingly program in any other form. 

Knuth has said the same thing about 
his approach, but, as Ed points out, the 
programming world has not beaten a path 
to Knuth’s door demanding WEB. Maybe 
it lacks something. Maybe that something 
is outlines. 

LEO is specifically a text editor for C 
programs (it also supports C++ and 
Objective-C syntax). It employs a simple 
language called SWEB, based on Knuth’s 
WEB, but considerably simpler (Ed took 
out all the typesetting code). Your pro¬ 
gram is expressed primarily in the body 
text of headlines that you create. This body 
text consists of plain C (C++, Objective- 
C) code, with additional directives defined 
by the SWEB language. You use LEO’s 
Tangle command to translate the SWEB 
code to C code. 

The combination of outlines and SWEB, 
Ed claims, makes programming signifi¬ 
cantly easier and more fun. And while out¬ 
lines impose a hierarchical structure, they 
don’t impose a single hierarchy. You can 
organize and reorganize your program at 
will, creating different views and organi¬ 
zations of the same program. 

Leo in Action 

In LEO or in WEB, you use this notion of 
sections to structure your code. Ed claims 
several virtues for sections: 


• A section name is more descriptive than 
a function name, and helps create self- 
documenting code. 

• Sections provides a convenient place for 
lengthy comments that would otherwise 
clutter up code. 

• Sections can be used to define nonex¬ 
ecutable code such as data structures. 

• Defining sections is easier than defin¬ 
ing macros or functions; there is nev¬ 
er any need to create prototypes for 
sections. 

• Sections may access the local variables 
present where the section is refer¬ 
enced, just as in a macro expansion. 
Usually this is exactly what is wanted, 
and there is no need to define and 
pass parameters. 

As I said, Ed is making the source to 
LEO available (not for free, though, and 
subject to a license that I haven’t seen yet). 
Example 1 is a snippet of the code for the 
print function, written using LEO, to 
demonstrate that coding with LEO isn’t 
too unfamiliar. 

Up, Up, and Away 

I was wondering whatever became of the 
Japanese Fifth Generation Computing ef¬ 
fort, so I did some research. 

In 1981 Kazuhiro Fuchi announced the 
Fifth Generation Project, the same year 
U.S. artificial-intelligence pioneer Edward 
Feigenbaum started the first successful 
artificial-intelligence company, Teknow- 
ledge. The following April, the Fifth Gen¬ 
eration Project was officially launched with 
a multimillion-Yen budget to develop hard¬ 
ware and software, focusing on parallel 
processing and logic, to solve problems 
requiring inference. 

Hundreds of researchers worked on the 
project at any one time, and it became 
one of the best training grounds for com¬ 
puter scientists in Japan. Five different 
computers came out of the project over 
the next ten years, as well as a special¬ 
ized operating system, database systems, 
and programming tools. In 1992, at the 
end of the project, Feigenbaum visited 
Japan and judged the Japanese work to 
be at least on a level with work done in¬ 
dependently in the U.S. Some of the work 
was definitely the most advanced in the 
world. But traditional PCs and worksta¬ 
tions soon surpassed the power of the 
Fifth Generation hardware. And the soft¬ 
ware, written for the obsolete hardware, 
was largely ignored. In 1992, The Ministry 
of International Trade and Industry grant¬ 
ed the researchers a two-year extension 
to port the software to UNIX, and the Fifth 
Generation Project dissolved in 1995. 

The software, which was placed in the 
public domain, may yet be used on 
UNIX-based highly parallel multiprocessor 
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machines, but the most important out¬ 
come of the Fifth Generation Project may 
be that it gave an unparalleled educa¬ 
tion to a generation of young computer 
scientists. 

Two Bits Make a Quantum Leap 

Man was not meant truly to understand 
quantum physics. Not this man, anyway. 

I read a lot about it, and just when I think 
Fve really understood some crucial con¬ 
cept, I look at it from another point of 
view and it makes no sense to me. 

When quantum computing takes over, 
I’m going to be in trouble. Fortunately, it 
looks like quantum computers won’t 
bump the PC off my desk or yours. They 
will be used, when they are actually prac¬ 
tical, for certain specialized tasks, such as 
factoring large numbers. Okay, some of 
you are thinking of reasons why you 
might want to factor large numbers on 
your desktop PCs. Maybe you’ll have QCs 
alongside or instead of your PCs. 

By encoding information in spin states 
of a proton, say, which exist as a super¬ 
position of both 0 and 1 until a measure¬ 
ment is made, a QC can theoretically ex¬ 
plore different paths through a mathematical 
problem simultaneously, making them use¬ 
ful for factoring and cryptographic work. 

But quantum computers are a long way 
from practical today. It’s amazing enough 
that they are even considered possible. 
Now Isaac Chuang of IBM’s Almaden Re¬ 
search Center and Neil Gershenfeld of MIT 
are claiming that they’ve built one and that 
it can answer two questions about four 
numbers, like “which of the number 1,2, 
3, or 4 is greater than 2 and odd.” The 
“computer” consists of the nuclei of a car¬ 
bon atom and a hydrogen atom in a chlo¬ 
roform molecule, manipulated by mag¬ 
netic fields and radio waves. 

According to Lov Grover, a physicist at 
AT&T Bell Labs, Chuang and Gershenfeld 
have demonstrated “that quantum com¬ 
puting works, not just with pencil and pa¬ 
per, but in the lab.” 

LEO Gets Down to Business 

The first business computer was not a 
quantum computer but a cold-cut com¬ 
puter. It was built by a British catering 
company, according to a new book by 
David Caminer, John Aris, Peter Hermon, 
and Frank Land ( LEO: The Incredible Sto¬ 
ry of the World’s First Business Computer , 
McGraw Hill, 1997). 

If that’s not weird enough for you, how 
about this: In 1947, two bean counters 
from Lyons & Co., the catering company, 
visited the Princeton lab where ENIAC 
was being built. They went home and told 
management, in effect, “We oughtta get 
us one of these things.” Lyons funded 
some computer research at Cambridge, 


Example 1: Sample LEO code. 

where some of the fundamental steps in 
inventing the digital computer were be¬ 
ing taken, and a couple of years later took 
the fruits of that investment, hired some 
engineers, and built a computer. They 
were up and mnning with custom catering- 
business software by 1951. 

The computer was called the Lyons 
Electronic Office, or LEO. Then again, es¬ 


tablishing firsts in computer history is like 
defining nationhood. A fictional Irishman 
once defined a nation as “the same peo¬ 
ple living in the same place. Or also liv¬ 
ing in different places.” That was Leopold 
Bloom, from James Joyce’s Ulysses , and 
another Leo. 

DDJ 


void print(void) 

I 

FTAG("print"); 

<<< Define print vars >>> 

STATB(ftag); 

<<< Return if there is nothing to print >>> 

<<< Save the old port >>> 

PrOpen(); if (PrErrorO != noErr) goto done; 

<<< Create a TPrint Record, goto close on error >>> 
cur_res_file = CurResFileO ; 

PrValidate(print_h); 
if (PrJobDialog(print_h) == FALSE) { 
cancel.flag = TRUE; goto close; 

} 

<<< Initialize the page counts >>> 

<<< Warn about any print errors >>> 
done: 

<<< Restore the old port >>> 

STATX(ftag); 

} 
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C PROGRAMMING 


Windows CE 

Al Stevens 



L ast month, I described my first foray 
into Windows CE programming. I 
talked about the usability and perfor¬ 
mance of the first generation handheld 
PC (HPC) devices. I also rued the limited 
ability of this platform to support real-time 
applications. Since writing that column, I 
attended the Windows CE Developer’s 
Conference. This conference is in its fourth 
year and is hosted by Microsoft. Attendees 
are typically C and C++ programmers who 
are or want to be developing programs to 
run on Windows CE devices. The new 
SDK also supports CE application devel¬ 
opment with Visual Basic. 

Microsoft now identifies three specific 
platforms for Windows CE devices, each 
with its own unique programming con¬ 
siderations. 

• First are the so-called PC Companion 
devices, which include HPCs and the 
new breed of Palm PCs. They’re called 
PC Companions, because you need a 
desktop or laptop PC to print, archive, 
and transmit your information. Com¬ 
panions have a screen and a GUI with 
a Start Menu and all that. HPC devices 
have keyboards. Palm PC companions 
do not. 

• The second platform is the Auto PC, a 
specialized device for your car’s dash¬ 
board. 

• Third is the embedded systems platform, 
which might not have a screen or a key¬ 
board or any other device other than 
memory and a microprocessor and 
which probably does have proprietary 
devices with custom device drivers writ¬ 
ten by the product developers. 

The Windows CE SDK plug-in to Visu¬ 
al C++ supports all these platforms. 

If you are a big fan of Windows CE, 
you might not like what I have to say. In 
my considered opinion, Windows CE in 
its current incarnation isn’t there yet. Its 
three platforms, cute and endearing as 
they are, fall short of adequately sup- 

Al is a DDJ contributing editor. He can be 
contacted at astevens@ddj.com. 


porting their respective targeted users for 
different reasons, which I’ll address later. 
Its development environment—the Win¬ 
dows CE SDK running under Windows 
NT 4.0—is buggy, fragile, and tempera¬ 
mental, as you too will be after trying to 
install it. 

Those opinions notwithstanding, you are 
likely to find gainful employment as a C++ 
programmer who knows the Windows CE 
development environment because Mi¬ 
crosoft is in full promotional hyperspeed 
and, if the growing attendance at this con¬ 
ference is any indication, product managers 
and their developers are listening. 

New HPCs 

HPCs have an allure, to be sure. The oth¬ 
er day, I was looking at a display of hand¬ 
held devices at Computer City. A fellow 
standing next to me was slathering over 
a first generation Casiopeia A-11, now re¬ 
duced to half its original price. I told him 
I have one and hate it and said why. He 
pointed to a PalmPilot and said he couldn’t 
understand why anyone would want one 
of those little devices. I answered that 
PalmPilot has about a million happy users. 
He ignored all that valuable witness, 
turned his attention back to the A-ll, and 
with a glazed stare wondered out loud if 
his company would buy him one. Logic 
cannot penetrate the protective shields of 
an enamored consumer about to part with 
plastic. 

All the vendors who exhibited at the 
conference displayed new HPCs with Win¬ 
dows CE 2.0. Each new machine sports a 
slightly bigger keyboard than the first gen¬ 
eration, and several have well-lit color dis¬ 
plays. Those with monochrome displays, 
even with their backlighting, continue to 
be unreadable in all but the brightest of 
lighting conditions. Only two vendors, 
NEC and Hitachi, have keyboards that I 
would consider using to touch-type. These 
machines are pricey but have some po¬ 
tential for road warriors. They are not 
pocket rockets, being just a bit smaller 
than the smallest notebook computers. 
They use proprietary battery packs, which 
sacrifices the convenience of flashlight bat¬ 


teries and adds a charger, power cord, and 
maybe a second battery pack to what you 
have to lug around. They are companions; 
you still need a desktop connection. In 
other words, new generation HPCs have 
few of the advantages of the original 
HPCs, or of conventional notebooks, and 
most the disadvantages of both. The form 
factors are growing, but the technology 
has yet to reach maturity. 

Want Your Palm Read? 

During the conference, we learned that 
3Com, purveyors of the very popular 
PalmPilot product line, had sued Microsoft 
in Europe for trademark infringement over 
the use of the name “Palm PC.” We then 
heard that 3Com had prevailed in that ac¬ 
tion, forcing Microsoft to find a different 
name for the line, which several manufac¬ 
turers have already begun to produce. Mi¬ 
crosoft did not comment on this judgment, 
but, without enough time to change its slide 
shows, continued to use the name “Palm 
PC” to represent those products through¬ 
out the conference. After the conference, 
we learned that the new Microsoft moniker 
would henceforth be “Palm-size PC.” 

Several booths allowed attendees to try 
out Palm-size PC devices. My first reac¬ 
tion: Microsoft doesn’t get it. The Palm¬ 
Pilot is popular because it is simple and 
easy for users and programmers. PalmPi- 
lots do not have multitasking, Control Pan¬ 
els, Registries, drivers, and exotic Setup 
programs to confound programmers and 
confuse users. Palm-size PC devices, on 
the other hand, have all that. They are nar¬ 
row Windows CE devices without key¬ 
boards. The Windows UI paradigm, com¬ 
plex enough on desktops and marginal at 
best on HPCs, doesn’t port well at all to 
the smaller Palm-size PC form factor. 
(That’s twice. “Form factor” is a new buzz- 
phrase to add to your technocabulary. Ev¬ 
ery pitch at the conference was liberally 
sprinkled with form factors.) 

My reaction to the Palm-size PC? All con¬ 
ference attendees were promised one to 
be mailed in a month or two when the lit¬ 
tle boxes are in full production. I’ll reserve 
final judgment until I get mine (assuming 
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that lowly members of the press qualify 
for the freebie; I’m sure not going to buy 
one). At first glance, the product line looks 
like a knee jerk reaction to someone 
(3Com) who is making a lot of money sell¬ 
ing a computing device that Microsoft does 
not control. 

Auto PC 

The second Windows CE platform is the 
Auto PC, which is a device to be installed 
in the dashboard of a car. It is voice ac¬ 
tuated and presumably can send and re¬ 
ceive e-mail, trade stocks, and do other 
urgent tasks that cannot wait until you get 
where you are going. It also reports on 
your car’s status— something that gauges 
and idiot lights apparently no longer do 
well enough— and connects to a GPS so 
you don’t get lost on your way to the lo¬ 
cal cyber cafe. There were three luxury 
cars parked on the conference tradeshow 
floor. Attendees could climb in and try out 
the Auto PCs while spectators viewed the 
devices on video monitors. Every time I 
went to look at one, somebody was sit¬ 
ting in the driver’s seat, yelling at the de¬ 
vice, trying to get it to do something. I 
overheard a young programmer express 
his enthusiasm about the Auto PC after 
climbing out of the Jaguar convertible. 


“What a cool device! I’ve got to have one! 
As soon as they are available, I’m getting 
one, for sure!” Then, after a pause he 
added, “I guess I’ll have to get a car, too.” 

The voice-recognition Auto PC opens 
a whole new arena for road rage. Instead 
of flipping the bird or shooting out some¬ 
one’s tires, you can pull up next to their 
convertible and yell at their Auto PC, “Buy 
10,000 shares of Borland!” or “Forward all 
personal e-mail to wife!” 

I give Auto PCs the same chance for 
universal acceptance that pen computing 
enjoyed a few years ago. Maybe Genera¬ 
tion X or whoever follows them into the 
21st century will find compelling uses for 
this new technology while it waits for 
some important problem to solve. Re¬ 
member CB radio? I’m hanging on to my 
road maps and watching the mechanical 
fuel gauge at least for a while. This skep¬ 
ticism kept me from going to any of the 
Auto PC technical sessions, so I have noth¬ 
ing more to report. I just don’t see any fu¬ 
ture in it. 

Embedded Systems 

Microsoft is positioning Windows CE as 
an embedded operating-system platform. 
The company presents this position as if 
it was the plan all along, but I smell revi¬ 


sionism. Every session that addressed the 
Embedded Developer’s Kit (EDK), or em¬ 
bedded development in general, paid lip 
service to real time requirements. It grudg¬ 
ingly acknowledges that Windows CE, 
which uses the Windows operating mod¬ 
el for sending notification messages to ap¬ 
plications in response to events, is not a 
real-time operating system. Windows CE 
ISRs cannot be nested; an event cannot 
interrupt an interrupt service routine. They 
suggest that a program should signal a 
thread from its ISR and exit the ISR as 
soon as possible to permit other interrupts 
to be sensed and processed. The me¬ 
chanics of a thread receiving a signal in¬ 
volves the Windows messaging system, 
which sends a notification message to a 
window whenever the heck it feels like 
it. Windows CE 2.0, the current version, 
does not correct this problem; neither does 
2.1, soon to be released. Microsoft ex¬ 
pressed its commitment to solving the real¬ 
time issue with interrupt and ISR latencies 
of 30 and 100 microseconds in a future 
version; they seemed surprised that a sig¬ 
nificant majority of the attendees were em¬ 
bedded system programmers. 

This apparent real-time support defi¬ 
ciency in Windows CE prompted many 
offline discussions. At lunch one after¬ 
noon, one of the guys polled for a con¬ 
sensus definition of “real time.” Those at 
the table generally agreed that real-time 
requirements are a function of the appli¬ 
cation and can be expressed in measure¬ 
ments that range from nanoseconds to fort¬ 
nights. How fast must a system respond 
to an external event and what are the con¬ 
sequences if the response is late or lost? 
Is the user taking an online examination, 
trading stocks, piloting a spacecraft, or 
stitching a microscopic suture during by¬ 
pass surgery? From that consensus we 
agreed that Windows CE could claim to 
be a real-time operating system only for 
applications with real-time requirements 
that fit within CE’s operating envelope. 

In other words, you can’t define real 
time outside of the context of some spe¬ 
cific real-time requirements. Given that 
vague definition, a batch payroll system 
could be called real time if it consistently 
delivers paychecks to the employees by 
quitting time on payday. Which is why I 
reject that definition. 

Until Microsoft adds true real-time sup¬ 
port, it cannot credibly claim that Win¬ 
dows CE is a serious player in the em¬ 
bedded operating-system market. 

C++ Exception Handling: Why Not? 

During several technical sessions, the pre¬ 
senters pointed out that Visual C++ does 
not support Standard C++ exception han¬ 
dling (the try/throw/catch idiom) when 
compiling to a Windows CE target. They 
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made vague references to platform in¬ 
compatibilities. That reason does not make 
sense to me. C++ exception handling is a 
language issue implemented in code. Its 
implementation has nothing to do with 
the platform. The compiler emits code into 
statement blocks that can throw excep¬ 
tions. That code stores in a table some¬ 
where the addresses of automatic in¬ 
stances of classes that have destructors 
and the addresses of the destructors. The 
throw mechanism uses that table to call 
the destructors as it unwinds the stack. 
It’s just code that occupies memory. 

The only valid reason I can see for dis¬ 
abling the feature is because of the added 
overhead. I surmised that a platform with¬ 
out enough memory to support exception 
handling isn’t going to be able to do much 
recursion or store and pass any sizable in¬ 
stance variables. In other words, it isn’t 
going to be able to support languages 
such as C and C++ that use the stack for 
local variables and function arguments. 

I stopped by the Metrowerks booth to 
look at the CodeWarrior compiler for Win¬ 
dows CE. They told me the same story. No 
C++ exception handling or RTTI because 
of platform restrictions. Figuring I’d have 
a better chance of talking to a compiler 
builder at Metrowerks, I called the com¬ 
pany. It turns out that Metrowerks fully in¬ 
tends to include exception handling sup¬ 
port in a future version of its CE C++ 
compiler. Metrowerks just hadn’t done it 
yet. But it has successfully implemented 
the feature in the Metrowerks PalmPilot 
compiler, which has a much smaller (ahem) 
form factor than the typical CE device. 

PalmPilot 

My latest electronic toy acquisition is the 
3Com PalmPilot. I got one because it was 
on sale, because it actually fits in a shirt 
pocket, because everyone I know who 
has one likes it, and because there is a 
C++ compiler for developing applications. 
This is one delightful little machine. Its el¬ 
egance is found in its simplicity. I’ll report 
more when I have the Metrowerks com¬ 
piler and can build an application. 

The Windows CE SDK 

Last month, I told of my frustrations get¬ 
ting the SDK installed and working in a 
new NT system. The conference materi¬ 
als included the latest SDK version, one 
that supports 2.0 and the new platforms. 

Since last month, I had learned that Vi¬ 
sual C++ and Internet Explorer 4.0 are not 
compatible on NT 4.0. When both are in¬ 
stalled and you run Developer Studio, 
something happens internally that screws 
up the Registry irrecoverably. The symp¬ 
tom shows up when you try to log in as 
other than an administrator. Things stop 
working and go downhill from there un¬ 


til they reach bottom and NT won’t boot. 
Because of that, I had to reformat the 
NTFS drive, reinstall NT, and start over 
again. 

I installed VC++ 3.0 and the new CE 
SDK on my clean NT workstation. Fol¬ 
lowing the instructions, I reinstalled Ser¬ 
vice Pack 3. Something in this procedure 
caused NT’s Remote Access Server to 
refuse to start. I removed and reinstalled 
Remote Access Server. All attempts to ac¬ 
cess the CE device from this point forward 
forced NT into an unstable condition in 
need of a reboot. 

Those of you who have had this expe¬ 
rience or similar ones are nodding grave¬ 
ly and feeling my pain. Those of you who 
had no such problems are gnashing your 


teeth and preparing to fire off e-mail to 
tell me what an idiot I am. I don’t know 
which group is the majority, but this I do 
know: Until Microsoft makes this develop¬ 
ment environment more stable, program¬ 
mers are going to look elsewhere for a 
way to write CE programs— or for better 
platforms to support. 

I do not have a happy ending here. I 
am overdue on this deadline and the prob¬ 
lem remains unsolved while I write. Sure¬ 
ly it can be solved, and certainly I will 
solve it, even if I have to call in my secret 
weapon (my daughter Sharon) who is a 
Microsoft Certified Systems Engineer on 
the NT platforms. I’ll let you know. 

DDJ 
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JAVA Q & A 


How Do I Process Images with Java? 

Aaron Michael Cohen 



T he Java API defines an abstract imag¬ 
ing model that can be used to display 
and manipulate both static images and 
sequences of images. The imaging 
model is defined in terms of the interac¬ 
tions between an abstract class, Image , and 
three interfaces: ImageProducer, Image- 
Consumer , and ImageObsewer. These in¬ 
terfaces and their support classes are de¬ 
fined in the java.awt.image package. 

The Image abstract class represents a 
platform-independent displayable image. 
Images can be created from image files 
loaded from the local file system or over 
a network using getImage(URL url) or 
getImage(URL url, String name). These 
functions will only succeed with files us¬ 
ing one of the supported file formats. Cur¬ 
rently, JPEG and GIF file formats are uni¬ 
versally supported. 

Images can also be created with a call 
to the createlmage() function of an AWT 
Component or available Toolkit object. 
There are several forms of the createlm- 
age() function: 

• Image createlmageQmageProducer 
source) creates an image from an ob¬ 
ject implementing the ImageProducer 
interface. 

• Image createlmage(int width, int height) 
creates a blank image of a given size 
that can be drawn on using a Graphics 
object. 

• Image createlmage(hyte[] imagedata) 
creates an image from JPEG or GIF for¬ 
mat data stored in an array. Only avail¬ 
able in Java 1.1 or later. 

• Image createlmage(hyte[] imagedata, int 
offset, int length) creates an image from 
JPEG or GIF format data stored in length 
bytes of an array starting at the given off¬ 
set. Only available in Java 1.1 or later. 

One of the createlmage() methods lets 
you create an Image from an ImagePro¬ 
ducer. You can retrieve the ImageProducer 
associated with an image by using the Im- 
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ageProducer getSourceO method of the 
Image class. 

Drawing onto an image is accom¬ 
plished by using the methods of the 
java.awt. Graphics class. Create a Graph¬ 
ics object associated with the image by 
using the getGraphicsO method. Anyone 
who has programmed in Java even a lit¬ 
tle has written the code to draw an image 
into a existing Graphics context by call¬ 
ing drawlmage() inside a Component's 
paint() handler, so I will not cover that 
in more detail here. 

An image also has properties such as 
width and height, which can be retrieved 
with methods defined in the Image base 
class. Java has the built-in capability to 
download and display images in the back¬ 
ground. Because of this it is possible to 
call methods on an Image object before 
the necessary data is available. These 
methods require an ImageObsewer as a 
parameter. For example, the getWidthO 
and getHeight() methods each require an 
object implementing the ImageObsewer 
interface as a parameter. When the re¬ 
quested information cannot be returned 
immediately, these functions return -1. 

The ImageObsewer interface defines 
one method, imageUpdate (see Example 
1). When an operation on an Image ob¬ 
ject cannot be completed immediately be¬ 
cause the data is not yet available, a thread 
is created, which loads the data in the 
background. As the data is loaded, image- 
UpdateO of all registered image observers 
is called notifying the observer of progress. 
The img parameter refers to the image for 
which there is new information. The in- 
foflags parameter is a set of flags that de¬ 
fine what type of information is now avail¬ 
able. The meaning of the rest of the 
parameters is dependent upon the con¬ 
tent of infoflags. Returning true from 
imageUpdate() requests further informa¬ 
tion on the image. The function should 
return false if the ImageObsewer is not in¬ 
terested in any further callbacks for this 
image. All AWT components implement 
the ImageObsewer interface. The default 
behavior repaints the image when addi¬ 
tional pixel data arrives. You usually do 
not have to override the default compo¬ 
nent implementation. 

So where does the image data come 
from? Each Image is associated with an 


ImageProducer, which can be retrieved 
by calling the getSourceO method on the 
Image object. The ImageProducer is re¬ 
sponsible for delivering the image data 
upon request to ImageConsumer objects. 
An ImageProducer object makes calls on 
the methods of the ImageConsumer in¬ 
terface to inform the ImageConsumer of 
the image type, size, and pixel data. Both 
the ImageProducer and ImageConsumer 
interfaces are defined in the java.awt.im¬ 
age package. The relationship between 
the classes in the Java imaging model 
looks like Figure 1. 

All of the methods of the ImagePro¬ 
ducer class have to do with ImageCon¬ 
sumer objects registering as consumers 
with the producer object and requesting 
data. These methods are fairly straight¬ 
forward: 

• void addConsumeflmageConsumer ic) 
adds a consumer to the ImageProducer. 
The consumer will be delivered image 
data the next time new data is available. 

• boolean isConsumer(ImageConsumer 
ic) determines whether a consumer is 
currently registered with the Image- 
Producer. 

• void removeConsumer(ImageConsumer 
ic) removes the given consumer from 
the producer’s list of consumers. 

• void requestTopDoivnlejtRightResendClm- 
ageConsumer ic) requests the produc¬ 
er to resend its image data in top-down, 
left-to-right order. The producer may 
choose not to honor this request. 

• void startProductionQmageConsumer 
ic) registers a consumer with the pro¬ 
ducer and deliver the current image data 
to the consumer as soon as possible. 

More interesting than the methods of 
the ImageProducer interface are the meth¬ 
ods of the ImageConsumer interface, which 
an ImageProducer calls to deliver the im¬ 
age type, size, and pixel data to the con¬ 
sumer object. These methods can be de¬ 
scribed as follows: 

• void setDimensions( int width, int height) 
is called to notify the consumer of the 
image’s size. This notification will be 
called before the first call to setPixels(). 

• void setColorModel(ColorModel cm) is 
called with a ColorModel parameter, 
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which will be the color model of most, 
but not necessarily all, of the pixels de¬ 
livered to the setPixelsO method. This 
notification is optional. If called, it will 
be invoked before the first call to set- 
Pixels(). 

• void setHints(int hintflags) notifies the 
consumer of the order in which pixels 
will arrive, which the filter may use to 
optimize some operations. For exam¬ 
ple, the COMPLETESCANLINES flag will 
be set if each call to setPixels() will de¬ 
liver entire unbroken scan lines (rows) 
of pixels, and the TOPDOWNLEFT- 
RIGHT will be set if the pixels will be 
delivered in top to bottom, left to right 
order. This notification is optional. If 
called it will be before the first call to 
setPixels(). 

• void setProperties(Hasbtable props) is 
used by the consumer to add some 
programmer-defined information to the 
image stream. This notification will be 
called before the first call to setPixels(). 

• void setPixels() passes the image pixels 
to the consumer by calling this method 
one or more times. Each call will deliv¬ 
er a rectangle of image pixels to the 
consumer. The layout of the pixels de¬ 
livered will correspond to any informa¬ 
tion sent in an earlier call to setHints(). 
There are two versions of this method. 
One which receives 32-bit pixel data 
and another which receives eight-bit 
pixel data. 

• void imageComplete(int status) is called 
with a status parameter to inform the 
consumer that a complete static image 
has been delivered, one frame of a 
multiframe image has been delivered, 
or an error has occurred. This notifica¬ 
tion will be called after the last call to 
setPixels(). 

The setPixelsO method requires more 
explanation. The full function prototypes 
of the two setPixelsO functions look like 
Example 2. A portion of the image is de¬ 
livered to an ImageConsumer with each 
call to setPixels(), which may be as large 
as the entire image, or as small as one pix¬ 
el. The portion delivered in each call to 
setPixelsO is a rectangle whose upper-left 
corner is at x,y and has a width of w and 
height of h. The data is passed in the ar¬ 
ray object pixels, which has valid data 
starting at position offset , and scansize el¬ 
ements between each row. What all this 


public boolean imageUpdate( 

Image img, int infoflags, 
int x, int y, int width, 
int height); 
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Example 1: The ImageObserver 
interface. 
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boils down to is that the sample in the 
pixels buffer which corresponds to the 
image pixel(m,n) is at array index offset 
+ (n-y)*scansize + (m-x). The only valid 
pixel array sample values are those that lie 
in the rectangle described by w, h, offset, 
and scansize. The producer will continue 
to call setPixelsO until all of the image pix¬ 
els have been delivered, or an error occurs. 

ColorModels 

The delivered image data may consist of 
32- or 8-bit samples. A ColorModel is 
passed along with the image data in each 
call to setPixelsO so that consumers can 
retrieve and manipulate the color infor¬ 
mation in the samples. The data in the 
pixels buffer is defined in terms of the 
ColorModel passed with the pixels. The 
ColorModel passed in the setColorModel 
call is only a hint to the consumer that the 
majority of pixels will use that model; you 
still need to check the ColorModel passed 
in each call to setPixelsO. 

The ColorModel abstract class defines a 
set of functions that an ImageConsumer 
uses to map a pixel value to red, green, 
blue, and alpha values. The functions int 
getReddntpixel), int getGreen(intpixel), int 
getBluef intpixel), and int getAlpha(intpix¬ 
el) return the components for the given pix¬ 
el value. Each color component can take 
on a value between 0 and 253, inclusive, 
with 0 being the minimum of a component 
and 255 being the maximum. The alpha 
component quantifies the transparency of 
the pixel and ranges from 0, which lets an 
underlying image show through complete¬ 
ly, to 255, which is opaque. 

All ColorModel objects also define a 
function, int getRGB(intpixel), which re¬ 
turns the color of a given pixel value in 
terms of the default color model, which 
is known as the RGBDefault color mod¬ 
el. An instance of the RGBDefault color 
model is returned by calling the Color- 
Model static function, getRGBdefaultC). 
The RGBDefault color model uses 32-bit 
data samples and allocates eight bits each 
for red, green, blue, and alpha with a bit 
layout of OxAARRGGBB. 

A ColorModel object that allocates a por¬ 
tion of the total bits in a sample to each 


(a) 

void setPixels( int x, int y, 
int w, int h, ColorModel 
cm, byte[] pixels, int 
offset, int scansize); 

(b) 

void setPixels( int x, int y, 
int w, int h, ColorModel 
cm, int[] pixels, int 
offset, int scansize); 


Example 2: Function prototypes of 
the two setPixelsO functions. 


color component is known as a Direct- 
ColorModel. A color model which uses the 
pixel value as an index into a palette of 
colors is called an IndexedColorModel. Di- 
rectColorModel objects implement func¬ 
tions that allow you to determine which 
bits of the pixel are allocated to each com¬ 
ponent. These are int getAlphaMaskO, int 
getRedMaskO, int getGreenMaskO, and 
int getBlueMaskO. The RGBDefault color 
model is a DirectColorModel. 

In general, eight-bit samples correspond 
to palette-based color models and 32-bit 
samples correspond to direct color mod¬ 


els such as 32-bit RGB. However, a Col¬ 
orModel is a flexible representation that 
can be used to convert between pixel val¬ 
ues and red, green, blue, and alpha com¬ 
ponents in any way that may be appro¬ 
priate. For example, a topological map 
image could be stored as an array of ints 
with each sample representing the eleva¬ 
tion of its location. A color model could 
then be created, which mapped the ele¬ 
vation to some standard topological map 
colors. This color model would be an in¬ 
dexed color model, however since the 
samples are stored as integers and not 



Figure 1: Relationship between the basic classes and interfaces of the Java 
imaging model. 
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bytes, it could have many more than 256 
entries and thus very fine shading of col¬ 
or to represent changes in geography. 

Image Processing 

Image processing with Java is accomplished 
using image filters, which are objects de¬ 
rived from the ImageFilter base class. The 
ImageFilter class implements the Image- 
Consumer interface to receive the pixel 
samples for the image to be processed. An 
ImageFilter has a protected member vari¬ 
able, consumer , which refers to the Im- 
ageConsumer downstream of the image fil¬ 
ter. Essentially, an ImageFilter is an 
ImageConsumer that manipulates the in¬ 
coming pixel data and forwards the results 
to another ImageConsumer object. 

As the image filter processes the sam¬ 
ples received in its setPixels() function, 
the filter sends the processed samples 
downstream by passing the samples to the 
setPixels() function of its consumer. The 
image filter can pass the pixels to its con¬ 
sumer as it receives and processes the 
samples, or the filter can save the raw or 
processed pixels in a buffer and send them 
all at once to the consumer when the fil¬ 
ter’s imageComplete() method is called. 
The default implementation in the Im¬ 
ageFilter base class is a null filter. For each 
call to setPixelsO, the base class simply 
calls the corresponding function in the 
consumer without modifying the samples. 
The rest of the methods inherited from 
the ImageConsumer method are similarly 
forwarded to the downstream consumer. 

The Java API includes a few built-in fil¬ 
ters to handle common tasks. The Repli- 
cateScaleFilter will stretch or shrink an im¬ 
age to a given size by dropping or 
duplicating samples. The AreaAverag- 
ingScale filter resizes an image using a bi¬ 
linear interpolation algorithm. The Croplm- 
ageFilter extracts a rectangular subimage 
from the original image. 

The FilteredlmageSource class 

Given that you have an instance of an Im¬ 
ageFilter object, how do you apply it to 
an image? This is where the Filteredlm¬ 
ageSource class comes in. An instance of 
the FilteredlmageSource class is an Im- 
ageProducer that creates a new image 
source from a given ImageProducer and 


an ImageFilter. The resulting image source 
produces an image which has been pro¬ 
cessed by the image filter. 

Example 3 should make this clear. First, 
an image is loaded from the local file sys¬ 
tem using the default toolkit. Then an 
AreaAveragingScaleFilter is created which 
will scale images to half the size of the 
original loaded image. Next, a Filtered¬ 
lmageSource object is created from the 
scaling filter and the ImageProducer of 
the original image. Finally, an Image ob¬ 
ject is created from the new Filteredlm¬ 
ageSource. Basically the Filteredlmage¬ 
Source constructor adds an image 
consumer/source pair in between the orig¬ 
inal ImageProducer and any future con¬ 
sumers. This process can be repeated any 
number of times to create an image filter 
chain or “pipeline;” see Figure 2. 

It is important to realize that the image 
data is not actually filtered until it is re¬ 
quested by a consumer. Typically this is 
done implicitly when the image is dis¬ 
played by calling drawlmage(), although 
any ImageConsumer can start the pipeline 
flowing by calling startProductionO on 
the ImageProducer at the end of the 
pipeline. Notice that downstream Fil¬ 
teredlmageSource objects forward deliv¬ 
ery requests upstream. Eventually the re¬ 
quest arrives at an image source that has 
image data ready to deliver and this Im¬ 
ageProducer object invokes methods on 
its registered consumers to push image 
data through the pipeline. 

Image Filters 

There are an infinite variety of filtering 
operations that can be applied to images 
in order to enhance or modify them. For 
the purposes of image processing with 
Java, filters can be classified according to 
the information required in order to pro¬ 
cess each sample. Here, we will classify 
image filters as point operations, geomet¬ 
ric operations, or neighborhood filters. 

Point Filters 

The simplest filters process each sample 
independent of the surrounding samples. 
These filters can be simple color modifi¬ 
cations, or can be dependent upon the 
pixel’s location in the image. In any case, 
a point operation filter only has knowl¬ 


edge of a single pixel at a time. Contrast 
enhancement, color inversion, and dither 
filters, among others, can be written this 
way. This type of filter is so common that 
the Java API includes a special base class, 
RGBImageFilter, which makes imple¬ 
menting point operation filters very easy. 

The RGBImageFilter class implements 
all the necessary ImageFilter machinery 
to filter an image pixel by pixel. One ab¬ 
stract function, int filterRGB(int x, int y, 
int rgb), needs to be implemented. This 
function is called for each pixel in the im¬ 
age and passed the pixel location as well 
as the 32-bit default RGB color model sam¬ 
ple value. The filterRGB() function in the 
derived class should return the processed 
pixel value using the 32-bit default RGB 
color model. 

Listing One (listings begin on page 124) 
is the implementation of the GreyOutlm- 
ageFilter , which demonstrates the use of 
the RGBImageFilter class. This filter sim¬ 
ply replaces half of the original image pix¬ 
els with grey using a checkerboard pat¬ 
tern. This is an effect which you may want 
to use to make an icon or button appear 
inactive. Notice how short the implemen¬ 
tation is. All the hard work has been done 
for us in the base class. 

GreyOutlmageFilter also demonstrates 
the proper way to handle the canFil- 
terlndexColorModel protected member 
variable. For indexed color images, RGB¬ 
ImageFilter attempts to be more efficient 
by filtering only the color table, not the 
entire image. If the results of the filter are 
only dependent upon the color of each 
filter, the derived class should set this 
member to true. If the results depend 
upon the pixel location, as they do in the 
GreyOutlmageFilter , then canFilterlndex- 
ColorModel must be set to false. 

Geometric Filters 

Another kind of filter moves pixels from 
one location in an image to another. These 
are known as geometric transformations. 
This is a very broad category and includes 
many types of filters including horizontal 
and vertical flipping, mirroring, and rota¬ 
tions. The Java API does not provide a 
specialized base class for implementing 
geometric operations like it does for point 
operations. We need to derive geometric 
transform filters from ImageFilter. 

Listing Two implements a filter that ro¬ 
tates an image 90 degrees clockwise. An 
mxn pixel image is transformed into an 
nxm pixel image, with the pixel value oc¬ 
cupying the original upper-left now oc¬ 
cupying the upper-right corner. 

The code is longer than that of the pre¬ 
vious filter because we need to override 
several functions of the ImageFilter base 
class. To properly rotate the image, we need 
to save the width and height passed into 
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Figure 2: Image processing pipeline. 
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Image big_image = getDefaultToolkit.getImage(“lena.jpg”); 

ImageFilter shrinker=new AreaAveragingScaleFilter(big_image.getWidth()/2, 

big_image.getHeight() / 2); 

ImageProducer source=new FilteredImageSource(big_image.getSource(), 

shrinker); 

Image small_image=createlmage(source); 


Example 3: Using an ImageFilter with the FilteredlmageSource class. 


setDimensionsC), and pass appropriate hints 
to the base class setHints(). Notice that af¬ 
ter processing these values, you invoke the 
superclass implementation. For all of the 
functions in the ImageFilter class except set- 
PixelsO, you should invoke the superclass 
implementation to properly initialize the 
base class, passing either the original pa¬ 
rameters or values modified appropriately 
for your implementation. Calling the su¬ 
perclass also ensures that the information 
is passed along to downstream consumers. 

Image rotation is accomplished by tak¬ 
ing each row of the rectangle of pixels re¬ 
ceived in setPixels() and passing it to the 
consumer as a column. We do some coor¬ 
dinate transformation to ensure that the 
pixels wind up in the correct location. Since 
the filter typically passes a column of pix¬ 
els to the consumer, we clear the COM- 
PLETESCANLINES and TOPDOWNLEFT- 
RIGHT flags before we pass the hints along. 

Neighborhood Filters 

The most complex kind of filter that we 
will deal with here is the neighborhood 
filter. Each output pixel is a function of 
several nearby input pixels. Image sharp¬ 
eners, smoothers, high-pass filters, and 
general convolution all fit into this cate¬ 
gory. Usually the pixel neighborhood is a 
small window of pixels centered on the 
pixel being processed. Common window 
sizes are 3x3 and 5x5. There are also “sep¬ 
arable” image filters which process an im¬ 
age, a row, and then a column at a time. 
In this case, the neighborhood is com¬ 
posed of nearby pixels in the same row 
or column as the target pixel. 

The implementor of a neighborhood fil¬ 
ter must decide how to handle the image 
boundaries where there is not a full win¬ 
dow of pixels to process. Common strate¬ 
gies are to leave the boundary pixels un¬ 
processed, or to fill in the missing window 
samples by reflecting the image over the 
edge. The primary reason why imple¬ 
menting neighborhood filters with the Im¬ 
ageFilter class becomes complicated is that 
each call to setPixelsO may pass only a 
small subrectangle of the image. The pix¬ 
els at the edges of the subrectangles will 
not be delivered along with the neigh¬ 
borhood pixels required to process them. 
The easiest strategy to work around this 
problem is simply to save the image pix¬ 
els in a private buffer as they are deliv¬ 
ered to setPixels and process the image 
all at once when imageCompleteO is 
called. The fully processed image can then 
be delivered with a single call to the con¬ 
sumer’s setPixels() method. 

The SharpenlmageFilter (available elec¬ 
tronically; see “Resource Center,” page 3) 
uses this method to implement a 3x3 
sharpening filter. Notice that the image to 
be processed is separated into color com¬ 


ponents and stored in four arrays named 
red, green, blue, and alpha. This allows 
the filter to sharpen both direct and in¬ 
dexed color model images. 

Chaining Filters Together 

Applying an ImageFilter to a given Image 
with the FilteredlmageSource creates an 
image pipeline. If another filter is then ap¬ 
plied to the resulting image, the new Fil¬ 
teredlmageSource is added to the front of 
the pipeline. Each time the image is pro¬ 
cessed it is pushed all the way through 
the pipeline. If an image is filtered, and 
then displayed, applying another filter to 
the image results in repeating processing 
that has already been done as the origi¬ 
nal image source is sent all the way from 
the beginning of the pipe, through the 
previous filters and finally through the 
newest filter. Therefore when applying n 
filters in sequence to an image and dis¬ 
playing each intermediate result, the im¬ 
age is actually processed n(n + l)/2 times. 

The Java image processing API is flexi¬ 
ble and written this way to handle chang¬ 
ing source images. For example, if the orig¬ 
inal image source were video and not a 
still image, sending each frame though the 
entire pipeline would be the proper thing 
to do. However, it can be very inefficient 
when applying a series of filters to a still 
image in an interactive application. 

To overcome this unnecessary overhead, 
the BufferingFilteredlmageSource class 
(available electronically) can be used just 
like the FilteredlmageSource. For still im¬ 
ages, it buffers the result of applying its 
ImageFilter to the original image. When a 
downstream filter requests image data the 
BufferingFilteredlmageSource delivers the 
samples from its internal buffer instead of 
forwarding the request upstream. For an¬ 
imated GIFs and other image sequences, 
it functions identically to the Filteredlm¬ 
ageSource. Using this class makes apply¬ 
ing a sequence of filters, one at a time, 
much more efficient since each filter is ap¬ 
plied to an image only once. 

To keep the implementation as simple 
as possible, the BufferingFilteredlmage¬ 
Source internally uses the Filteredlmage¬ 
Source class to actually perform the image 
filtering. An instance of MemorylmageSource 
is created and stored in the source mem¬ 
ber and functions as the ImageProducer for 
the buffered, filtered image. If the image is 
animated, then no buffering is done and 


the FilteredlmageSource instance is used as 
the source instead. BufferingFilteredlm¬ 
ageSource implements the ImageProducer 
interface simply by forwarding the calls to 
the source member object. 

The only complexity in the implementa¬ 
tion is the BfisInternalConsumer class that 
the BufferingFilteredlmageSource uses to 
save the processed image in a buffer. The 
buffer is then used to create the Memory¬ 
lmageSource. Since the FilteredlmageSource 
object may deliver the filtered image syn¬ 
chronously or asynchronously, we need to 
allow for both cases. This is done by syn¬ 
chronizing the BufferingFilteredlmageSource 
constructor with the imageCompleteO func¬ 
tion of the BfisInternalConsumer using the 
object and the done flag. 

The JIPTestApplet 

To demonstrate the filters and classes pre¬ 
sented in this article, use the test applet, 
JIPTestApplet (also available electronical¬ 
ly), along with JIPTestApplet.html, which 
is an HTML page used to demonstrate the 
applet. The applet can be configured to 
display and process up to ten images. The 
filters given in this article can be applied 
repeatedly using either the Filteredlm¬ 
ageSource or BufferingFilteredlmage¬ 
Source. Applying several filters in succes¬ 
sion to a still image will demonstrate the 
efficiency gained by using the Buffering¬ 
FilteredlmageSource. Using the Filtered¬ 
lmageSource, , successive filter applications 
take longer and longer. Using the Buffer¬ 
ingFilteredlmageSource ?, each invocation 
takes the same amount of time. You can 
also use the test applet to explore the re¬ 
sults of applying several filters to an im¬ 
age, for example, the GreyOutFilter fol¬ 
lowed by the SharpenlmageFilter. 

Conclusion 

The Java image-processing model is 
powerful, flexible, and expandable, and 
can be used to create complex image- 
processing applications. Image process¬ 
ing is a computationally intensive activi¬ 
ty. With a JIT compiler, Java performance 
is more than adequate for basic process¬ 
ing of moderate sized images. For inter¬ 
preted Java virtual machines or complex 
multipass computations, the processing 
should be kept to small images. 

DDJ 

(Listings begin on page 124.) 
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ALGORITHM ALLEY 


Image Segmentation for 
Image Recognition 

Lee Kamentsky 



Good ideas reappear in surprising places. When Lee first told 
me about his algorithm, I thought he was discussing an old 
flood-fill algorithm— one that I remembered seeing long be¬ 
fore it appeared in Kent Porter’s “Graphics Programming” col¬ 
umn (DDJ, June 1989). There are good reasons for the simi¬ 
larity: Both algorithms rely on a fundamental insight that applies 
to many data-analysis tasks — where possible, work with 
groups of data, not with single elements. 


Rather than studying a single pixel at a time, Lee’s tech¬ 
nique immediately bundles pixels into larger structures. As in 
many graphics problems, the natural unit is a horizontal line 
of pixels. By quickly moving the problem from one involv¬ 
ing pixels to one involving lines, Lee reduces his work by an 
order of magnitude. 

—Tim Kientzle 


S ubtle variations of color and texture 
in photographic images make it dif¬ 
ficult to clearly identify a foreground 
and a background. It’s considerably 
simpler with “artificial” images, such as 
scanned text. The relatively high contrast 
makes it easier to separate pixels, but you 
still have to somehow identify regions of 
pixels and extract relevant information. In 
this article, I’ll describe an algorithm that 
quickly reduces high-contrast images to 
a data set that lends itself to image recog¬ 
nition and analysis. This algorithm could 
be used to analyze black text on a white 
background, calibration marks on a sur¬ 
face, red Legos in a toybox, or a slide con¬ 
taining blots of a drug being tested by a 
pharmaceutical company. 

The initial stage of image analysis usu¬ 
ally consists of two steps—thresholding 
and segmentation. Thresholding algorithms 
classify pixels as either foreground or back¬ 
ground, or classify pixels according to their 
foreground class (green, red, and blue class¬ 
es, for instance, or skin texture, hair tex¬ 
ture, and clothing texture). Thresholding 
algorithms can extend past analyzing the 
raw brightness or color of a pixel. Some 
involve linear transforms such as convolu¬ 
tion filters and FFTs. Others rely on non¬ 
linear transforms such as image dilation. 

Segmentation algorithms group simi¬ 
lar pixels together into coherent units. 


Lee is a software engineer at CompuCyte 
Corporation. He can be contacted at 
leek@msn.com. 


Segmentation is often regarded as a back¬ 
water of image analysis. However, a 
good segmentation algorithm can yield 
easily analyzable, abstract objects with 
a minimum of processing. The algorithm 
I describe here has good performance. 
It visits each pixel exactly once, pro¬ 
cessing the pixels in their raster order, 
which maintains cache coherency, im¬ 
proves bus bandwidth and eliminates 
disk thrashing. It yields data structures 
representing connected groups of pix¬ 
els; the data structures can be manipu¬ 
lated to extract information without re¬ 
visiting each pixel. 

The algorithm groups pixels into run- 
length encoded lines. It then groups the 
lines into structures I call “blobs.” The 
blobs contain groups of lines that over¬ 
lap. This yields an object that describes a 
set of four-connected (north, south, east, 
and west) pixels, none of which are con¬ 
nected to any pixel outside of the set. You 
can quickly find a blob’s extent, position, 
center, or area. You can analyze the blob’s 
topology and shape. You can revisit the 
pixels within the blob to determine their 
brightness, coloration, or texture. These 
techniques lend themselves to the tasks 
of optical-character recognition (OCR), 
scene recognition (where the scene con¬ 
sists of artificial, high-contrast objects), 
and automated chemical analysis. 

The Segmentation Algorithm 

Suppose you’re trying to analyze black 
text against a white background. In this 


context, the segmentation algorithm looks 
at one raster at a time and breaks it down 
into a series of black lines. Each line is 
compared to the lines on the previous 
raster (the “old line list”) and is either 
added to an existing blob or a new blob 
is created. 

If a blob has lines on the old line list, 
those lines are open lines. I maintain a 
count of open lines for each blob. When 
the count falls to zero, that blob is fin¬ 
ished and need no longer be considered. 
The bulk of the algorithm, then, consists 
of walking down the old line list and com¬ 
paring new lines to see how to attach 
them to blobs. 

The algorithm starts with the genesis of 
a new line. The application typically main¬ 
tains a threshold and scans until it finds a 
pixel whose value is over the threshold. 
It then starts a line and scans until it hits 
a pixel under threshold. The application 
then builds a line consisting of the X start, 
X end, and the current Y. The line also 
contains a pointer to its blob (null signals 
that the line is unattached) and a pointer 
to the next line in the blob. 

There are three possible relationships 
between the current old line and new line, 
as illustrated in Figure 1. 

• The old line might end before the new 
line begins; see Figure 1(a). 

• The new line might end before the old 
line begins; see Figure 1(b). 

• The two lines might overlap; see Fig¬ 
ure 1(c). 
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If the old line is wholly before the new 
line, it is finished. I decrement its blob’s 
open line count and, if the open line count 
has reached zero, add the blob to the list 
of finished blobs. I then advance to the 
next old line in the list. If the new line is 
wholly before the old line, then we have 
finished attaching the new line. If no pre¬ 
vious old line overlaps this new line, then 
the new line starts a new blob. 

The third case involves overlapping old 
and new lines. Its implementation requires 
two parts: attaching and ending. You at¬ 
tach the new line to an old line in one of 
three ways. If the new line is not yet linked 
to a blob, we link it to the old line’s blob. 
If the new line is already linked to the old 
line’s blob, then you increment the blob’s 


loop count (this is a signal that the blob 
split into two halves and these two halves 
have been rejoined by the new line, like 
at the bottom of the letter “O”). If the new 
line has already been linked to a blob oth¬ 
er than the old line’s blob, then the new 
line joins two blobs (like at the bottom of 
the letter “V”). You merge the two blob’s 
line lists and discard one of the blobs. 

Merging blobs is an important feature 
of any segmentation algorithm. Figure 2 
illustrates a particularly difficult example, 
in which three new lines combine four 
separate blobs. You need to compare the 
ends of the new and old lines after at¬ 
taching the new line. If the old line ends 
first, you can move onto the next old line. 
If the new line ends first, then you have 
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to increment the blob’s open line count 
(lines can now be attached to both the 
old and the new line). You then move on 
to create the next new line. 

The algorithm has one additional mi¬ 
nor complexity: At the end of a raster, you 
either am out of new lines or old lines. If 
you run out of new lines, you run through 
a loop that ends the remaining old lines. 
You decrement the open line counts and 
finish any blobs whose open line count 
falls to zero. If you run out of old lines 
first, you must create new blobs for each 
new line until the end of the raster. 


Additional Features 

It’s possible to augment this algorithm to 
collect additional information about each 
blob. I’ve already included the loop 
counts, since those are so easy to extract. 
The demonstration program makes use of 
the loop count to distinguish the loops in 
bullseyes: The bullseye rings must be 
closed to be recognized. You might also 
use the loop count to help in distin¬ 
guishing letters; uppercase “B” and low¬ 
ercase “g” are the only letters with two 
loops (assuming no malformations). 



Old Line 

1 1 1 

1 
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Line 


Figure 1: Possible relationships 
between old and new lines: (a) Old 
line ends first, advance to next old 
line; (b) new line ends first, advance 
to next new line; (c) old and new lines 
overlap, add new line to blob. 
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Another group of useful features are the 
image tops and bottoms. The tops are 
those lines that were not attached to any 
line above. The total number of tops is 
one more than the number of merges re¬ 
quired to produce the blob. The bottoms 
are those lines that had no other line at¬ 
tached below them. The algorithm can find 
these by setting a flag when first consid¬ 
ering an old line. The algorithm clears the 
flag if a new line attaches to the old line. 
You check the flag when finishing the old 
line; if it is still set, you have a bottom. 

Numbers of tops and bottoms by them¬ 
selves can be used to distinguish shapes. 
For instance, the letter “w” has three tops 
and two bottoms for both serif and sans- 
serif fonts, the small “m” has three tops and 
three bottoms. Positions of tops and bot¬ 
toms are perhaps more telling; a top di¬ 
rectly above a bottom may indicate a ver¬ 
tical line (in character recognition, this is 
typically the leftmost stroke of the letter). 
It’s quite possible to build a neural network 
character recognizer that uses a number of 
loops, top position, and bottom position 
as its input features; this recognition en¬ 
gine is efficient and provides a confidence 
output along with its judgment. 

Positional information can be recorded 
during segmentation. The algorithm can 
update the enclosing rectangle for the blob 
as it adds lines (the top of the blob is al¬ 
ways one of its starting lines, the bottom 
is always the old line at which the line 
count drops to zero). The algorithm can 
also compute the blob centroid (if each 
pixel weighed the same, the centroid would 
be the blob’s center of mass) and area. It 
may be more efficient, however, to com¬ 
pute these during a quick trip through the 
blob’s line list after it has been finished. 

Optimizations 

Ironically, the two most expensive parts 
of the segmentation algorithm are outside 
of the algorithm proper. Thresholding is 
the most expensive, because it requires 
examining each individual pixel. Using 
table lookups or other techniques that ex¬ 
amine several pixels at a time can help to 
speed this part. A quick optimization may 
be to check for all ones or all zeros. Typ¬ 
ically, though, thresholding is sped up 
through hardware assist: The data is 
thresholded, run-length encoded, and 
transmitted in encoded form. 

The second most expensive operation 
is allocation. Artifacts of image capture 


can often cause a jagged edge at the top 
of an object, The algorithm may create a 
blob initially for each of these jagged lines. 
Blob creation can be an expensive oper¬ 
ation, even if the blobs are unlinked from 
a private heap. It’s possible to modify the 
algorithm so that blobs are created only 
when a previously unattached new line is 
attached to a previously unattached old 
line. This delays blob creation past typi¬ 
cal effects caused by aliasing. A single new 
line joining many unattached old lines will 
only create a single blob. 

My implementation maintains an array 
of pointers to lines. This indirection can be 
eliminated by allocating all lines from a sin¬ 
gle array. You can then set an array index 
to the first line on the old line list and fetch 
subsequent old lines by incrementing the 
index. It’s possible in many operating sys¬ 
tems to reserve a large block of memory 
without actually allocating the backing store 
necessary to maintain the virtual memory 
image on disk (this is the VirtualAlloc func¬ 
tion in Windows 95/NT). The algorithm 
can reserve the theoretical maximum size 
memory required for the worst case (which 
is half the number of pixels in the image 
times the size of a line). The algorithm can 
perform the actual allocation at the begin¬ 
ning of the raster, enlarging the array of 
lines to prepare for the worst case. This 
eliminates the need to check for “out of 
memory” when allocating lines during the 
course of a scan. 

Finally, many processors have a sweet 
spot at 16 bytes when dealing with arrays 
of structures. (Typically, the bus is 32-bits 
wide and the bus bursts are four words 
long. A 16-byte structure makes optimum 
use of one burst.) The line structure con¬ 
sists of an X start, X end, Y coordinate, 
pointer to the next line in the blob, and 
pointer to the line’s blob. That’s 20 bytes 
if the algorithm uses 32-bit integers and 
pointers. Packing the X start and X end 
into two 16-bit words may provide a sig¬ 
nificant boost in speed. 

Applications 

The structures yielded by the segmentation 
algorithm lend themselves to a variety of 
uses. The lines provide compression for a 
number of tasks. First among these are 
tasks involving the relations of the blobs 
to each other and to the background. It’s 
an easy matter to relate the blobs to then- 
neighbors once they have been segment¬ 
ed; you can form agglomerations (such as 



Figure 2: An example of the difficult “w”problem. 
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lines of print or areas of half-tone dot im¬ 
ages) that provide useful feature infor¬ 
mation. My most recent use of the algo¬ 
rithm has been a bullseye recognizer that 
detects a microscopic bullseye deposited 
at an exact spot on a microscope slide by 
photolithography. The segmentation al¬ 
gorithm quickly identifies the two rings 
and target of the bullseye by searching for 
the only three objects that have centroids 
that are close together (the middle of each 
ring corresponds with the middle of the 
bullseye). 

It’s possible to perform template 
matches using the algorithm data struc¬ 
tures. (I’ve included a template matcher 
in Listing One; listing begins on page 
124.) A template matcher can match blob 
against blob. This is done by relying on 
the line order within the blobs to effi¬ 
ciently find which parts of the image 
overlap the template. The resulting score 
gives a confidence measure that the tem¬ 
plate is the same shape as the image. 
Template matching can be used in OCR 
to discriminate between letters that have 
similar overall shapes (such as “A” and 
“R,” which both have one loop, one top, 
and two bottoms). 

The segmentation algorithm can be 
used to find and outline objects de¬ 
posited on a substrate. For instance, a 


drug manufacturer might test thousands 
of variants of a drug at once using a 
robotic deposition tool that places the 
results of different reactions at different 
spots on a dish. The spots can be found 
using the segmentation algorithm and the 


The three parts of 
the bullseye have 
common centroids 


chemical reaction can then be analyzed 
by measuring the intensity and color of 
the reactions in the spot. The algorithm 
can be used in other aspects of robotics; 
a few marks on an object can be used 
to track the object in real time and po¬ 
sition it. Again, these algorithms work 
best in an artificial environment in which 


lighting and contrast are controlled to 
maximize the difference between fore¬ 
ground and background. 

Conclusion 

This segmentation algorithm rapidly iden¬ 
tifies the boundaries of contiguous objects 
from their background. It makes efficient 
use of modern CPU resources and yields 
objects with data structures that have util¬ 
ity. I believe that it could serve as the core 
of a number of interesting image pro¬ 
cessing applications. I would like to see it 
used in novel ways, such as in identify¬ 
ing— in real time—high contrast objects 
placed in video scenes as markers for an¬ 
imated characters. It might also be used 
as the base segmentation algorithm for real- 
world imaging using sophisticated image 
processing techniques that enhance fore¬ 
ground. The algorithm can be extended 
to three dimensions by matching against 
two old line lists: one in the X-Y plane 
and one in the X-Z plane. This adapta¬ 
tion might be used in computer-aided 
tomagrophy to identify tumors. In any 
case, the algorithm is dependable and use¬ 
ful and should serve you well in appro¬ 
priate applications. 

DDJ 
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DR. ECCO'S OMNIHEURIST CORNER 


Lines of Fire 

Dennis E. Shasha 



H e claimed to be a military man, but 
Captain Solo didn’t seem to have the 
right bearing. He slumped in one 
chair with his feet propped on an¬ 
other. His uniform was clean, but badly 
wrinkled. His hair was unkempt. In brief, 
he looked like one of my colleagues. 

His smartly dressed assistant, Lieutenant 
Hood, presented the problem to Ecco. “Here 
is the layout of the valley, sir,” he said. 

“Our hovertanks will be approaching 
from the eastern pass. When our adver¬ 
saries detect us, they will approach from 
the western pass. 

“Our job is to destroy the underground 
factories in the valley. The factories them¬ 
selves have no defenses except their one- 
meter-thick walls, but we must quickly 
dominate the ground above. That means 
we must rapidly reach a situation in which 
we can destroy any new vehicle that 
comes into the valley.” 

“Why can’t you just cross over with your 
first hovertank and block their pass?” Liane 
asked. 

“They have field guns and rocket- 
propelled explosives inside bunkers over¬ 
looking the western pass,” the lieutenant 
responded. “We have, however, located 25 
hills that are good vantage points for our 
hovertanks. Occupying any 10 of them will 
allow us to destroy the underground fac¬ 
tories. We just want to be safe on them 
while keeping our adversaries to under five.” 

“So, drive to the first 10 hills you can 
see,” Ecco said with some impatience. 

Solo spoke up. “We wouldn’t be here 
if it were that simple, Dr. Ecco. You must 
think of this as a two-person game with 
alternating moves. We place a vehicle, then 
they place one. Then we place one. Then 
they do. And so on. We just want to be 
sure that after they have placed five, they 
can’t place any more, whereas we can 
place at least 10 altogether.” 

“Can you get to any hill equally fast?” 
Liane asked. 

Solo nodded. “I designed every hover- 
tank to fly at 80 miles an hour and to stop 
on a dime.” 

“Unfortunately, our adversaries have access 
to the same technology,” added the lieutenant. 


Dennis, a professor of computer science at 
New York University and author of The Puz¬ 
zling Adventures of Dr. Ecco (Dover, 1998), 
can be contacted at DrEcco@ddj.com. 


“Our biggest advantage is that we will be 
in the valley first. In fact, we hope that we 
will be able to place at least two and pos¬ 
sibly three hovertanks on hills in the valley 
before they place any of theirs. After that, 
we will alternate. Remember, we want to 
prevent them from placing more than five 
of their hovertanks and we want to be able 
to place at least 10 of ours. Also, our 10 hov¬ 
ertanks must be able to fire upon all unoc¬ 
cupied hills. Finally, their five hovertanks 
must not be able to fire upon our 10.” 

“Can you tell me which hills can fire 
upon which others?” Ecco asked. 

“Yes,” the lieutenant responded, hand¬ 
ing Ecco the table below (also available 
electronically, see “Resource Center,” page 
3). “We’ve numbered the hills from 0 to 24. 
I hope the table is clear. For example, hill 
0 can fire upon hills 1 2 3 7 9 8 13 17 18 
19 20 22 24. Note that firing is usually but 
not always symmetric. For example, 0 can 
fire upon 2 but the reverse does not hold.” 

Fire From Fire Upon 

0 1 2 3 7 9 8 13 17 18 19 20 22 24 

1 0 2 3 9 10 13 14 15 16 17 20 21 24 

2 3 5 9 11 12 13 16 22 23 

3 2 5 7 9 11 12 13 16 22 

4 5 7 9 11 12 13 16 22 23 

5 2 3 4 7 9 11 12 23 

6 1 2 3 7 9 8 13 14 15 16 18 20 21 

7 3 4 5 9 12 19 20 22 23 

8 0 6 10 14 15 17 18 19 24 

9 2 3 4 5 7 11 19 20 22 

10 1 2 3 7 8 9 13 15 16 20 21 22 24 

11 2 3 4 5 9 19 20 22 23 

12 2 3 4 5 7 8 17 18 23 

13 0 1 2 3 6 7 9 10 16 18 21 22 24 

14 1 6 8 15 16 17 18 19 21 22 24 

15 1 2 3 6 8 10 14 16 18 19 20 22 

16 1 2 3 4 7 6 9 10 13 14 15 17 19 22 

17 0 1 8 14 16 18 20 21 24 

18 0 6 8 13 14 15 17 21 22 

19 0 8 14 15 16 20 21 22 24 

20 0 1 2 3 6 9 10 15 17 19 22 24 

21 1 6 10 13 14 17 18 19 24 

22 0 10 13 14 15 16 18 19 20 

23 2 4 5 7 11 12 19 20 22 

24 0 1 8 10 13 14 15 17 19 20 21 

Ecco and Liane studied the table for a 
while. Suddenly, Liane giggled and said, 
“Two sets of queens problems.” She then 
sketched something on paper that looked 
like two squares and showed it to Ecco who 
nodded. 

Ecco then turned to us and stifled a 
yawn. “Gentlemen, let me take a three, 
four, or five minute nap, and then I’ll get 
back to you.” 

When Ecco returned, he handed Cap¬ 


tain Solo a piece of paper. “If you can 
place three hovertanks before your ad¬ 
versaries can place any, then take these 
three and you can prevent the adversary 
from occupying any hills, because your 
hovertanks will be able to fire upon ev¬ 
ery remaining hill. If you can place only 
two before they can place any, then 
choose these two. You will be able to 
keep the adversaries to under five, occu¬ 
py 10 yourself, and be able to fire upon 
all remaining hills. If you can place only 
one before they can place any, then I don’t 
think you can achieve your goals, but I’m 
not sure and, well, you haven’t asked.” 

Reader: Please show Solo how (a) he can 
dominate the valley entirely by occupying 
three hills before his adversaries can oc¬ 
cupy any; and (b) he can achieve the con¬ 
ditions of the problem by occupying two 
hills before his adversaries can occupy any 
(and alternating thereafter). If you have 
a proof either way concerning the last prob¬ 
lem (if the adversaries allow Solo only one 
hill before alternating moves begins), then 
send it to me at DrEcco@ddj.com. 

Last Month's Solution 

Since each accusation must include at least 
one lying informant and all two accusa¬ 
tion pairs below are disjoint, there have 
to be at least six: 

Accuser Accused 

petra gwenyth. 

sam larry 

dave mike 

isaac nick 

hillary kris 

olivia ulm 

If the following eight people have been 
aimed, they suffice to explain all the accu¬ 
sations that commissioner Bratt has pre¬ 
sented to Ecco: isaac hillary larry olivia 
gwenyth dave sam petra. Ecco doesn’t know 
whether this is the minimum possible. 

Superheurists: DDJ readers Gary Knowles, 
Jon Beal, and Kent Donaldson all found 
clever solutions to the May 1998 Nimmer- 
ics problem. Kent also has the best solu¬ 
tion so far to the Territory Game in which 
his first six ships get 66.60 percent of the 
valley and all seven get 73.83 percent. 
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Listing One 

import java.awt.Color; 
import java.awt.image.*; 

public class GreyOutlmageFilter extends RGBImageFilter ( 

// save the int value of the grey color... 
protected int greyOutValue = Color.gray.getRGB(); 
public GreyOutlmageFilter() { 

// this filter is position dependent, so we can't filter 
//by just changing the color table... 
canFilterlndexColorModel = false; 

) 

public int filterRGB( int x, int y, int rgb) ( 

// set every other pixel to grey using a checkerboard pattern... 
if (((x A y) & 1) == 0) { 
return greyOutValue; 

} 

else { 

return rgb; 

} 

3 

] 


Listing Two 

import j ava.awt.image.*; 

public class RotateClockwiselmageFilter extends ImageFilter [ 
protected int srcwidth, srcheight; 
protected int destwidth, destheight; 
public void setDimensions( int width, int height) ( 

// source height becomes destination width and vice-versa... 
this.destwidth = height; 
this.destheight = width; 

// tell the consumer the size of the image that we will be sending... 
super.setDimensions( this.destwidth, this.destheight); 

public void setHints( int hints) ( 

// because this filter delivers pixels a scan column at a time, 

// we need to clear COMPLETESCANLINES and T0PD0WNLEFTRIGHT hint 
// bits and set the RAND0MPIXEL0RDER bit... 
hints = (hints & (~COMPLETESCANLINES) & 

(-T0PD0WNLEFTRIGHT)) ! RAND0MPIXEL0RDER; 

super.setHints(hints); 

) 

public void setPixels( int x, int y, int w, int h, ColorModel cm, 

int[] pixels, int offset, int scansize) { 

// start is the offset into buffer of first pixel of current source 
// row, which will become the top pixel in destination column... 
int start = offset; 

// destx is zero-indexed destination column of source pixel row... 
int destx = destwidth - y - 1; 

// send the pixels on to the consumer, each row of the source image 
// becomes a 1-pixel wide column of pixels in destination image... 
for (int j = 0; j < h; j++) ( 

consumer.setPixels( destx, x, 1, w, cm. pixels, start, 1); 
start += scansize; 
destx—; 

) 

) 

public void setPixels( int x, int y, int w, int h, ColorModel cm, 

byte[] pixels, int offset, int scansize) { 

// start is the offset into the buffer of the first pixel of current 
// source row, which will become top pixel in destination column... 
int start = offset; 

// destx is zero-indexed destination column of source pixel row... 
int destx = destwidth - y - 1; 

// send the pixels on to the consumer, each row of the source image 
// becomes a 1-pixel wide column of pixels in destination image... 
for (int j =0; j < h; j++) { 

consumer.setPixels( destx, x, 1, w, cm, pixels, start, 1); 
start += scansize; 
destx—; 

} 

} 

) 


ALGORITHM ALLEY 


Listing One 

void CMonochromeBitmap;:BuildBlobList() 

C 

CLineVectorlterator clviNew,clviEnd; 

AllocateLineBlock(clviNew,clviEnd); 
m_pBlob.reserve(eBlobsPerBlock); 

// Create two vectors of pointers to lines to hold the new line list 
// and the old line list. We initialize them to hold Width()/2 members. 

// This is the maximum possible number of lines. 

CLinePointerVector clpvRaster[2]; 
clpvRaster[0].reserve(Width()/2); 
clpvRaster[1].reserve(Width()/2); 
int nOldLinelndex = 0; 
int nNewLinelndex = 1; 

//At the start, the old line list has no members. 

CLinePointerVectorlterator clpviOldEnd = clpvRaster[nOldLinelndex].begin(); 
for (int nY = 0; nY < HeightQ; nY++) ( 

CLinePointerVector fcclpvOld = clpvRaster[nOldLinelndex]; 
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CLinePointerVector &clpvNew = clpvRaster[nNewLinelndex]; 
nOldLinelndex = nOldLinelndex A 1; 
nNewLinelndex = nNewLinelndex A 1; 

CLinePointerVectorIterator clpviOld = clpvOld.begin(); 

CLine *pLineOld; 
if (clpviOld == clpviOldEnd) 
pLineOld = NULL; 
else 

pLineOld = *clpvi01d++; 

CLinePointerVectorlterator clpviNew = clpvNew.begin(); 

// Get the raster to process and set up for the first byte 
const BYTE *pRaster = GetRaster(nY); 

BYTE bBit = 0x80; 

BYTE bByte = *pRaster++; 

// Set up the X extents, 
int nX = 0; 

const int nXEnd = Width(); 

while(nX < nXEnd) { 

CBlob *pBlob01d; 

// Search for the start of a line, 
while((bByte & bBit) == 0) { 

if (++nX == nXEnd) goto linedone; 
bBit = bBit » 1; 
if (bBit == 0) { 
bBit = 0x80; 
bByte = *pRaster++; 

) 

} 

// Start a line, 
if (clviNew == clviEnd) C 

// need more memory for lines. 

AllocateLineBlock(clviNew,clviEnd); 

} 

CLine StlineNew = *clviNew++; 
lineNew.m_nXStart = nX; 
lineNew.m_pNextLineSameBlob = 0; 
lineNew.m_nY = nY; 

// Put it on the new list. 

*clpviNew++ = StlineNew; 

// Find the extent of the line, 
do C 

if (nX == nXEnd) break; 
bBit = bBit >> 1; 
if (bBit == 0) { 
bBit = 0x80; 
bByte = *pRaster++; 

} 

nX++; 

} while (bBit St bByte); 
lineNew.m_nXEnd = nX - 1; 

// Now finish all old lines wholly before our new line 
if (pLineOld) C 

while (pLineOld->m_nXEnd < lineNew.m_nXStart) C 
pBlobOld = pLine01d->m_pBlob; 
if (—(pBlobOld->m_nO£enLines) == 0) { 

AddBlob(pBlobOld); 

} 

if (clpviOld == clpviOldEnd) { 
pLineOld = NULL; 
break; 

) else ( 

pLineOld = *clpvi01d++; 

) 

) 

) 

// Do the first line that overlaps our new line 
if (pLineOld StSt pLineOld->m_nXStart <= lineNew.m_nXEnd) ( 
pBlobOld = pLineOld->m_pBlob; 
lineNew.m_pBlob = pBlobOld; 

*( pBlobOld->m_ppLastLine) = StlineNew; 

pBlobOld->m_ppLastLine = St(lineNew.m_pNextLineSameBlob); 

// See if the new line ends the old line or vice-versa, 
if (pLineOld->m_nXEnd > lineNew.m_nXEnd) { 

// the old line extends past the new line. 

// the new line gives the old line's blob another open line. 

pBlobOld->m_nOpenLines++; 

continue; 

} else { 

//we close the old line and extend the blob at the 
// same time. We continue to close old lines, 
if (clpviOld == clpviOldEnd) ( 
pLineOld = NULL; 

} else ( 

pLineOld = *clpviOld++; 

while(pLineOld->m_nXEnd <= lineNew.m_nXEnd) { 

// End this line too. We have two cases: 

CBlob *pBlobOther; 

if ((pBlobOther = pLine01d->m_pBlob) == pBlobOld) ( 

// the old line is part of the new line's blob. 

// This is just a loop. 
pBlob01d->m_nLoops++; 
pBlobOld->m_nOpenLines—; 

) else ( 

// This is the merge case 
pBlobOld->Merge(pBlobOther); 
delete pBlobOther; 
pBlob01d->m_n0penLines—; 

) 

if (clpviOld == clpviOldEnd) ( 
pLineOld = NULL; 
break; 

) else ( 

pLineOld = *clpvi01d++; 

) 

) 

if (pLineOld && pLineOld->m_nXStart <= lineNew.m_nXEnd) ( 
// This last old line overlaps and ends the new line. 
CBlob *pBlobOther = pLineOld->m_pBlob; 


if (pBlobOther == pBlobOld) ( 
pBlobOld->m_nLoops++; 

} else { 

pBlob01d->Merge(pBlobOther); 
delete pBlobOther; 

) 

) 

} 

) 

} else { 

// This is the case where no line overlaps the new line. 
// Start a blob with this line. 

CBlob *pBlobNew = lineNew.m_pBlob = new CBlob; 
pBlobNew->m_nOpenLines = 1; 
pBlobNew->m_pFirstLine = SlineNew; 

pBlobNew->m_ppLastLine = &(lineNew.m_pNextLineSameBlob); 
pBlobNew->m_nLoops = 0; 

) 

} 

linedone: 

if (pLineOld) { 
while (TRUE) { 

// Finish all old lines. 

CBlob *pBlob01d = pLineOld->m_pBlob; 
if (—(pBlob01d->m_n0penLines) == 0) ( 

AddBlob(pBlobOld); 

) 

if (clpviOld == clpviOldEnd) break; 
pLineOld = *clpvi01d++; 

} 

) 

// Finally, record the end of the new list as the 
// end of the old list to be. 
clpviOldEnd = clpviNew; 

} 

//At the end, we've got one last raster of lines to finish. 
CLinePointerVector SclpvLast = clpvRaster[nOldLinelndex]; 
for (CLinePointerVectorlterator clpvi = clpvLast.begin(); 
clpvi != clpviOldEnd;) { 

// Finish all old lines. 

CBlob *pBlob01d = (*clpvi++)->m_pBlob; 
if (—(pBlob01d->m_n0penLines) == 0) { 

AddBlob(pBlobOld); 

) 

) 

// and finally, segmentation is complete 


DDJ 



GUARANTEE! 

If you are not 
100%satisfied, 
write, "cancel" 
on your invoice 
and 

the FREE issue 
is yours to keep. 


ySulfi-OS'GW* 


• J ' pi0U9 Mo, 1 ev Problems 
Solving Money r 
with wonay-^ 1 


, Namesp3 ceS 


Get the working code, tools 
& techniques GUARANTEED 
to make you a 

better C and C++ programmer 


Call 

TODAY 

for your 
FREE 
Trial 
Issue! 


www.cuj.com 


Advanced Solutions for Professional Developers 


800-365-1364 P.O. Box52582 

FAX 303-661 -1 885 Boulder, CO 80322-2582 

Email: cuj@neodata.com 

(Orders outside the U.S. must prepay. 
Canada/Mexico: 1 year-$46. Outside North America: $65 U.S. Funds) 


Dr. Dobb’s Journal, July 1998 


125 
























rrosoft 


Microsoft fress 


The world's 


most perfq 

eloped softWi 


I: 


D8l6 Rogerson 




Inside 

Windows NT 

Second Edition 


Inside 


Distrib 


You supply the creative vision, and Microsoft Press helps you turn vision 
into reality with the definitive programming guides for Microsoft® Windows NT® 
and component development. Inside Windows NT, Second Edition, is the 
authoritative blueprint you need to unlock the full power and performance 
of the Windows NT platform. Inside COM is your clear and simple, practical 
guide to building elegant COM components. Inside Distributed COM helps you 
use Microsoft’s Distributed Component Object Model to create powerful new 
business solutions based on multi-tier or even truly distributed applications. Be 
the ultimate insider and see what develops. Microsoft Press will help you 

start faster and go farther. 


© 1998 Microsoft Corporation. All rights reserved. Microsoft, Microsoft Press, Windows NT, 
and Where do you want to go today? are either registered trademarks or trademarks of 
Microsoft Corporation in the United States and/or other countries. 


Where do you want to go today?® 


Microsoft Press 


mspress.microsoft.com 


Available in quality bookstores and computer stores worldwide. To 

locate your nearest source for Microsoft Press® products, reach us at: 
1-800-MSPRESS in the U.S., or mspress.microsoft.com 










































































PROGRAMMER'S BOOKSHELF 


Displacement and 
Other Stories 

Gregory V. Wilson 


D isplacement is a wonderful thing. I’m 
two months away from the next ma¬ 
jor release of the product I’m re¬ 
sponsible for, I have a training course 
on software engineering for scientists and 
engineers to write, and what am I doing? 
I’m watching Working Model (http://www 
workingmodel.com/) simulate a stepping 
gear called a “Geneva wheel.” Working 
Model is a GUI version of first-year 
physics: Arbitrary shapes can be sketched, 
connected, given physical properties such 
as mass and elasticity, and then set in mo¬ 
tion to interact according to F=ma and, 
um, gosh, it’s been a long time since I did 
physics, hasn’t it? 

Once I’ve finished playing with gears, 
I’m going back to LCSI’s Micro Worlds 
(http://www.lcsi.ca/), a multimedia version 
of the Logo educational programming en¬ 
vironment. Logo is interactive, forgiving, 
and graphical, so that children can easily 
create and explore. In a better universe, it 
would have revolutionized the way com¬ 
puters are used in schools. This latest in¬ 
carnation adds sound, web publishing, and 
a multitude of other new features, without 
obscuring its central simplicity. If you want 
your children to learn how to think with 
their computers, instead of just treating it 
as TV with hyperlinks, then MicroWorlds 
is definitely worth a look. 

A couple of hours with either of these 
programs is enough to make most pro¬ 
grammers ask themselves, “Why aren’t my 
tools this easy to use?” According to the 
contributors to Software Visualization , edit¬ 
ed by John Stasko, John Domingue, Marc 
H. Brown, and Blaine A. Price, part of the 
answer is that we make far too little use of 
interactive 2D and 3D graphics. Even the 
most advanced integrated-development en¬ 
vironments (IDEs) are built around a text 
editor. It might highlight syntax and it might 
be accompanied by some list boxes or trees 
showing files and classes, but it’s still just 
vi on steroids. If you compare this to the 


Greg is the author (/Practical Parallel Pro¬ 
gramming (MIT Press, 1995), and coedi¬ 
tor with Paul Lu of Parallel Programming 
Using C++ (MITPress, 1996). Greg can be 
reached at gvwilson@interlog.com. 
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dozens of sketches that programmers draw 
to show data structures, inheritance, and 
control flow, you can see how much more 
we could be doing. 

Computer-aided software engineering 
(CASE) tools have tried to integrate struc¬ 




tured diagrams into IDEs. (A good entry- 
level example is Stingray’s Visual CASE, at 
http://www.stingsoft.com/vcase/.) Most of 
the systems discussed in Software Visual¬ 
ization take the opposite approach, and try 
to use visualization to examine or explain 
existing programs. Some of the results leave 
me cold, but some, like the classic “Sorting 
Out Sorting” by Baecker et al., are as illu¬ 
minating as Working Model’s gears. 

Of course, most contributions fall some¬ 
where between these two extremes. The 
code-maintenance visualizer by Eick et 
al., for example, shows source files as 
strips, then color codes them line by line 
to indicate how frequently or recently they 
have changed. The resulting display 
would be a useful adjunct to a source- 
code control system, but its utility is lim¬ 
ited by the fact that it reports changes to 
physical structure (lines), rather than log¬ 
ical stmcture (classes or methods). Still, 
like many other chapters in the book, it 
is an interesting starting point for further 
development, and provides a glimpse of 
what your next programming environ¬ 
ment might look like. 

Mark Murphy’s C/C++ Software Quali¬ 
ty Tools is a nice complement to this, since 
it looks at what your current programming 
environment ought to provide, but prob¬ 
ably doesn’t. According to the blurb on 
the back of this book, Murphy has worked 
on software quality assurance since 1990; 
judging from the book’s clarity and com¬ 
mon sense, I would have guessed that 
he’d been in the business much longer. 

Along with three introductory chapters, 
two chapters on testing in general, and a 
brief concluding chapter, Murphy gives 
us one chapter on each of six different 
quality-assurance tools. The first of these 
is a home-brewed version of the assert() 
macro. This doesn’t extend the func¬ 
tionality of the standard C++ assert() by 
much, but even experienced program¬ 
mers will learn a few things from Mur¬ 
phy’s discussion of when and how to 
use assertions. 

The second tool he describes keeps 
track of dynamically allocated memory, 
and reports both out-of-bounds writes 
and memory leaks. Commercial varieties 
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(continued from page 127) 
of such tools, such as Purify (http:// 
www.rational.com/products/purify/) and 
BoundsChecker (http://www.numega. 
com/ products/cc/screen_cb.htm), are 
taken for granted by most professional 
programmers, but this is the clearest ex¬ 
planation I have ever seen of how they 
work, and what they can and cannot do. 

The third, fourth, and fifth chapters on 
tools describe an automatic test-case gen¬ 
erator, a scripting language that can be used 
to drive tests, and a coverage tool that keeps 
track of which statements and branches in 
a program have been executed. All of these 
ought to be as widely known and widely 
used as the memory checkers discussed in 
the previous paragraphs; but because test¬ 
ing is a low-status occupation, they are ig¬ 
nored by most educators and profession¬ 
als (see http://www.ddj.com/oped/1997/ 
wilson.htm). 

The last of Murphy’s tool-oriented 
chapters describes a tool for capturing 
and replaying keystrokes and mouse 
movements, so that GUI testing can also 
be automated. Some people question the 
effectiveness of automated testing (see 
http://www.stlabs.com/testnet/docs/ 
snakeoil.htm, for instance), but the tool 
itself is still worthy of study. 

As good as it is, C/C++ Software Quali¬ 
ty Tools does have one major weakness, 
which is its use of a home-grown script¬ 
ing language as a test driver. Several well- 
documented, extensible, general-purpose 
scripting languages are widely used today, 
including Perl, Tel, and Python. Any of 
these would, in my opinion, have been a 
better choice for Murphy than developing 
his own. What’s more, the test generator 
and coverage tool would both be easier to 
extend or retarget if they had been written 
in one of these higher-level languages, 
rather than in C or C++. Despite this, and 
a lack of exercises and sample problems, 
this book would be a solid text for an un¬ 
dergraduate course on quality assurance. 

Speaking of Perl... 

I’ve been working my way through three 
new books on the language during the 
past few weeks, and have been impressed 
by all of them. Nigel Chapman’s Perl: The 
Programmer’s Companion and Jon Or- 
want’s Perl 5 Interactive Course are both 
tutorials. At nearly 300 pages instead of 
Orwant’s back-breaking 900, Chapman’s 
book is thinner and more discursive, but 
contains neither self-quizzes nor exercises. 
Orwant’s book, in contrast, describes Perl 
a snippet at a time, and has hundreds of 
multiple-choice questions and exercises. 
Orwant also goes into a lot more detail 
when discussing widely used Perl mod¬ 
ules for process management, database 
access, and networking. I would recom¬ 


mend Chapman to Perl newcomers and 
Orwant to those who need to master the 
language, but given Chapman’s lack of 
exercises, Orwant is probably a better 
buy either way. 

Like Scott Meyers’ Effective C++, on which 
it is modeled, Joseph Hall’s Effective Perl 
Programming is not for the faint-hearted. 
Sixty items, grouped into 10 sections, cov¬ 
er everything from the difference between 
undefined and empty lists, through differ¬ 
ent ways of reading from a stream, to us¬ 
ing the debugger effectively and submitting 
modules to the Comprehensive Perl Archive 
Network (http://www.perl.org/CPAN/, and 
many mirror sites). While the book is in 
some ways an indictment of Perl’s quirki¬ 
ness— if the language had fewer syntactic 
and semantic inconsistencies, the book 
could be a lot shorter—it ought to be in 
the stack underneath every serious Perl pro¬ 
grammer’s coffee mug. 

The last of this month’s books is Robert 
Glass’s Software Runaways: Monumental 
Software Disasters. In this book, Glass looks 
at large projects that have spiralled out of 
control and subsequently failed. He states 
his thesis early: 

...the most common problem in building 
software systems is not the construction of 
them itself, but rather the estimation of the 
costs of that construction. Why is there such 
a problem? Because the software field has 
not made a conscientious effort to devel¬ 
op histories of past project costs. 

He then summarizes the findings of stud¬ 
ies done in 1989 and 1993. Not surprisingly, 
failed projects tend to be those that were 
overly ambitious, for example, and project 
failure usually has several causes, rather 
than a single dominant cause. At the same 
time, using packaged software instead of 
rolling your own doesn’t appear to reduce 
the risk of project failure, but using new 
technology (or technology that is new to 
the organization responsible for the pro¬ 
ject) greatly increases the risk. 

If the bulk of the book was devoted to 
this sort of summarization and analysis, I 
would probably add it to my recom¬ 
mended reading list. Unfortunately, most 
of the rest of the book consists of reprints 
of articles about particular runaway pro¬ 
jects, including the Denver airport bag¬ 
gage handling system, the FAA’s next- 
generation Air Traffic Control system 
(which replaced single keystrokes with 12 
or more mouse clicks), and Bank of Amer¬ 
ica’s MasterNet. Some of this is interest¬ 
ing, but only some, and only somewhat. 
Still, if it is not a step toward developing 
the history of past project costs that Glass 
says our profession needs, it is at least a 
signpost in that direction. 

DDJ 
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OF INTEREST 



Modern Software Publishing has released 
Modern GuardX, an application security 
solution for Windows 95/NT applications. 
GuardX acts like a firewall for applica¬ 
tions, preventing unauthorized access to 
programs, program features, dialogs, and 
user-interface elements based on user log¬ 
on credentials. GuardX lets you add U.S. 
Department of Defense C2-class security 
to business applications. GuardX supports 
Visual Basic, Access, Office, VBA, Visual 
C++, and other development environ¬ 
ments. GuardX unit pricing is $698.00 
with a one-year software maintenance 
subscription, free technical support, and 
a 30-day money-back guarantee. 

Modern Software Publishing Inc. 

Five Youngs Road 
Pomfret Center, CT 06239 
860-963-1071 

http://www. modernsoftware. com/ 

ValiCert’s recently announced ValiCert 
Toolkit 2.0 lets you embed certificate val¬ 
idation into any application. Version 2.0 
of the toolkit supports all current digital 
certificate validation and revocation pro¬ 
tocols, including mechanisms such as Cer¬ 
tificate Revocation Lists (CRLs), the new¬ 
ly proposed Online Certificate Status 
Protocol (OCSP), and ValiCert’s unique 
Certificate Revocation Trees (CRTs). The 
toolkit consists of software components 
that enable Internet applications to veri¬ 
fy digital certificates using an array of es¬ 
tablished validation mechanisms. The Vali¬ 
Cert Toolkit 2.0 is available free of charge 
for an unlimited binary license and can 
be downloaded from http://www.val- 
icert.com/. 

ValiCert 

3160 West Bayshore Road 

Palo Alto, CA 94303 

650-849-9860 

http://www. valicert. com/ 

Plexstar has released Java modules that 
read, write, and display CAD files based 


on the DGN and DXF formats. The new 
modules are the DGN reader/writer add¬ 
on and the DXF reader/writer add-on. 
Plexstar Inc. 

3951 Pender Drive, Suite 105 
Fairfax, VA 22030 
703-246-9640 
http ://www. plexstar. com/ 

American Cybernetics has announced Ver¬ 
sion 8 of its programmer’s text editor, 
Multi-Edit. Multi-Edit 8 features support 
for HTML, JavaScript, VBScript, Perl, Java, 
and other languages. Multi-Edit includes 
Project and Site Management tools, and 
IDE integration with Borland Delphi and 
C++ Builder. A free, fully functional demo 
of Multi-Edit 8 is available for download 
at http://www.multiedit.com/. 

American Cybernetics Inc. 

1830 West University Drive, Suite 112 

Tempe, AZ 85281 

602-968-1945 

http://www.multiedit.com/ 

Software Tree has released JDX 1.0, an 
all Java implementation that provides an 
object-oriented interface to store and re¬ 
trieve Java objects in a relational database. 
JDX provides support for complex object 
modeling and for object integration with 
legacy data. 

Software Tree Inc. 

650 Saratoga Avenue 
San Jose, CA 95129 
408-557-6769 

http:// www. softwaretree. com/ 

Formula One/Java from Visual Compo¬ 
nents is an Excel-compatible spreadsheet 
written in Java. Formula One/Java pro¬ 
vides Excel read-write compatibility and 
more than 130 worksheet functions. For¬ 
mula One/Java can be downloaded from 
http://www.flj.com/. A developer license 
can be purchased for $49.00 per devel¬ 
oper. Server licenses are available for 
$499.00 per server/per application. An un¬ 
limited distribution license is available for 
$5000.00. 

Visual Components Inc. 

12980 Metcalf Avenue, Suite 300 
Overland Park, KS 66213 
800-884-8665 

http://www. visualcomp .com/ 

Albert’s Ambry has introduced Zeus, a text 
editor/IDE designed specifically for pro¬ 
grammers. Zeus is customizable, language 
neutral, and works seamlessly with all 
third-party development tools and com¬ 
pilers. Zeus is available in 16- and 32-bit 
versions, both of which support back¬ 
ground compiling and build task runs. The 
editor supports keyboard mapping for 
Brief, WordStar, Epsilon, and Emacs, and 


has a built-in macro scripting language 
and color syntax highlighting. Zeus sells 
for $95.00 for a single-user license (mul¬ 
tiple licenses discounts available). 
Albert’s Ambry 
P.O. Box 2092 
Bala Cynwyd, PA 19004 
610-623-2014 

http://www.alberts.com/authorpages/ 

00002366/prod_270.htm 

The Open Group has announced X11R6.4, 
the latest release of the X Window Sys¬ 
tem technology. This release of the X Win¬ 
dow System technology allows existing 
shrink-wrapped or custom applications to 
be accessed by an Xll-enabled Web 
browser through such features as univer¬ 
sal access and Low-Bandwidth X. New ex¬ 
tensions and features include a reduction 
in the X server’s memory footprint, Easy 
Resource Configuration (ERC), the ability 
to allow a multithreaded system to func¬ 
tion as one large screen, Low-Bandwidth 
X, Display Power Management Signaling, 
and Colormap Utilization Policy. 

The Open Group 
11 Cambridge Center 
Cambridge, MA 02142 
617-621-8700 

http://www. opengroup. org/ 

Micro Digital and Swell Software have an¬ 
nounced PEG, a GUI for embedded sys¬ 
tems. PEG provides a set of graphical ob¬ 
jects such as windows, status and menu 
board, menus, buttons, icons, sliders, 
thumbwheels, tables, boxes, and more. 
PEG was designed specifically for em¬ 
bedded systems; the code size is under 
100 KB. Drivers for VGA, SVGA, and LCD 
controllers are included, as well as sup¬ 
port for mouse, touch screen, and key¬ 
board input. The PEG Font Capture utili¬ 
ty converts standard font files to the PEG 
format. The PEG Image Convert utility 
converts PCX, BMP, and TGA files to the 
compressed PEG format. PEG is supplied 
as a C++ library with source code, and 
costs $5000.00 royalty-free for one devel¬ 
oped product. 

Micro Digital Inc. 

12842 Valley View Street, #208 
Garden Grove, CA 92845 
800-366-2491 

http://www.smxinfo.com/ 

Metrowerks now officially supports the 
GNU GCC compiler from within the 
Code Warrior environment (as an alterna¬ 
tive to Metrowerks’ own compiler). A sub¬ 
sidiary, Quorum Technologies, has been 
formed for the express purpose of sup¬ 
porting GCC within Code Warrior. Quo¬ 
rum Technologies will provide bug fixes 
and full-service support for the GNU corn- 
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pilers, linkers, and debuggers. It will build 
reference versions of GCC compilers and 
linkers that are validated against Metro- 
werks Code Warrior GCC adapter tech¬ 
nology. 

Metrowerks Inc. 

9801 Metric Boulevard, Suite 100 
Austin, TX 78758 
512-873-4700 

http ://www. metrowerks. com/ 

ParaGraph PI, the Pen and Internet Tech¬ 
nology business unit of Silicon Graph¬ 
ics, has announced the CalliGrapher 5.1 
handwriting-recognition tool for Win¬ 
dows CE. Features in CalliGrapher 5.1 
include note-taking and screen draw 
support, support for color ink on color- 
enabled handheld PCs, a new method of 
quickly entering punctuation via pop-up 
menus, and an enhanced screen orien¬ 
tation feature. 

ParaGraph PI 

2011 N. Shoreline Boulevard, Bldg. 10 
Mountain View, CA 94043 
650-933-3000 

http://www.paragraph.com/ 

ObjectAda Real-Time RAVEN from Aonix 
employs a fast real-time kernel that is suit¬ 
ed for hard real-time and safety-critical 
applications. RAVEN’S design is based on 
the Ada95 tasking restrictions set named 
the RAVENSCAR Profile, which accom¬ 
modates certification requirements for 
high-integrity (safety-critical), real-time 
systems. The profile defines a special 
Ada95 tasking model with special em¬ 
phasis on small size, fast performance, 
and deterministic behavior. RAVEN sup¬ 
ports Solaris, HP/UX, and Windows NT. 
Target support for RAVEN includes Mo¬ 
torola’s PowerPC, MC680 x 0, and MC683xx. 
Pricing starts at $15,000. 

Aonix 

595 Market Street, 12th Floor 
San Francisco, CA 94105 
415-543-0900 
http://www.aonix.com/ 

ActiveState has released ActiveState Perl 
Debugger, a visual debugging environ¬ 
ment for Win32 Perl programmers. A sin¬ 
gle license costs $95.00; multiple licenses 
are available at discounted rates. 
ActiveState Tool Corp. 

P.O. Box 2870 Main Station 
Vancouver, BC 
Canada V6B 3X4 
604-606-4686 

http://www.activestate.com/ 

Dynamical Systems has introduced ready- 
Base, a dynamic and embeddable rela¬ 
tional database library with a high-level C 
API, as well as Perl and Java interfaces. 
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Features include rapid schema prototyp¬ 
ing, a fast and flexible engine, powerful 
query language, and platform indepen¬ 
dence. readyBase is currently available for 
Linux, Solaris, and Irix. 

Dynamical Systems Ltd 

175 W. Jackson Boulevard, Suite A253 

Chicago, IL 60604 

312-341-1755 

http://www.dynamical-systems.com/ 

Visual LISP from Autodesk is an integrat¬ 
ed development environment that supports 
an extension of the AutoLISP program¬ 
ming language. Visual LISP supports com¬ 
piled LISP, enhanced performance when 
running through AutoCAD Release 14, and 
an ActiveX interface. 

Autodesk Inc. 

Ill Mclnnis Parkway 
San Rafael, CA 94903 
415-507-5000 

http ://www. autodesk. com/ 

Artisan Software Tools has announced Ver¬ 
sion 2.0 of its Real-Time Studio modeling 
environment for developing real-time sys¬ 
tems. Version 2.0 features include UML- 
based requirements modeling, UML-based 
solution design, enhanced round-trip en¬ 
gineering, timing notes support, and a 
multiuser architecture. Real-Time Studio 
2.0 runs on Windows 95/NT, and supports 
C++ and Java. A single user license costs 
$4995.00. 

Artisan Software Tools Inc. 

820 Bay Avenue, Suite 120 
Capitola, CA 95010 
408-475-5554 

http://www.artisansw.com/ 

Halcyon Software has introduced Instant 
Basic for Java, a visual development en¬ 
vironment compatible with Microsoft Vi¬ 
sual Basic. Instant Basic for Java includes 
a compiler that compiles VB source code 
directly to Java bytecode. You can debug 
Java applications at the VB source-code 
level. The Professional Edition includes 
Professional Controls, ActiveX support, 
and DAO/RDO support with JDBC. In¬ 
stant Basic for Java Standard Edition costs 
$99.00, while the Professional Edition costs 
$795.00. 

Halcyon Software 
1590 La Pradera Drive 
Campbell, CA 95008 
408-378-9898 

http ://www. halcyonsoft. com/ 

ObjectStore PSE Pro Release 2.0, from Ob¬ 
ject Design, is a Java object database. Ob¬ 
jectStore PSE Pro stores and retrieves Java 
objects without translation, offers full 
querying and indexing capabilities, and 
supports JDK 1.2 collections. ObjectStore 


PSE Pro costs $245.00 per developer; an 
end-user license costs $95.00 per user with 
quantity discounts available. 

Object Design Inc. 

25 Mall Road 
Burlington, MA 01803 
781-674-5000 

http://www.objectdesign.com/ 

APEX Software has announced Version 5.0 
of its True DBGrid Pro ActiveX grid con¬ 
trol. Version 5.0 includes multiple lines per 
record, data-sensitive colors and graphics, 
drop-down data-aware list boxes, input 
masking, and context-sensitive CellTips. 
Pro 5.0 also includes reusable grid layouts 
and an add-in grid Design Assistant. 
TrueDBGrid Pro 5.0 costs $399.95. 

APEX Software Corp 
4516 Henry Street 
Pittsburgh, PA 15213 
412-681-4343 
http ://www. apexsc. com/ 

The KL Group has announced JProbe Pro¬ 
filer, a graphical hierarchical profiler for 
Java applets and applications. At its core 
is a standard Java VM, licensed from Java¬ 
Soft and instrumented by KL Group. Fea¬ 
tures include the ability to graphically view 
memory usage and instance counts of each 
object as the Java application runs, a Call 
Graph Interface, and an advanced source 
code display. JProbe runs on Windows 
NT and costs $499-00. 

KL Group Inc. 

260 King Street East 
Toronto, ON 
Canada M5A 1K3 
416-594-1026 
http://www.klg.com/ 

POET Software announced its new POET 
Content Management Suite, an extensible 
application built upon the POET object serv¬ 
er that adds XML/SGML functionality to ac¬ 
celerate deployment of solutions for struc¬ 
tured content management. The POET 
Content Management Suite includes the 
POET Content Client, the POET Content 
Server, and the POET Content SDK. In ad¬ 
dition to its support for XML/SGML content, 
it supports full-featured revision control, 
full-text indexing, workgroup collaboration, 
and previous version rollback. The POET 
Content SDK includes both a C++ and Java 
API. Pricing is $1500.00 for a client license, 
and $20,000 for a complete end-user pack¬ 
age, including training and support. 

POET Software Corp. 

999 Baker Way, Suite 100 

San Mateo, CA 94404 

650-286-4640 

http://www. poet. com/ 
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Serial Communication Libraries 

We fulfill all of your serial communica¬ 
tion needs for Windows NT, Windows 
95/98, Windows 3.x, and Msdos. 

COMM-DRV/Lib High speed serial communica¬ 
tion, file transfer, modem control libraries & DLLs. 
Supports most multiport cards under all Windows 
& MS-DOS. Timed & asynchronous callback 
events. (Price: $189.95) 

COMM-DRV/VxD VxD for ultra high speed serial 
communication on all single and multiport cards 
with the 8250, 16x50 family of UARTS. Multidrop 
& 9 Bit Protocol. Windows 95/98, & 3.x. ( Price: 

H $189.95) 


Multiport Cards 2, 4, & 8 port multiport RS232, 
RS422, RS485. (Price: $69.95 & above) 


Other tools: Si-Scope, serial communication 
hardware accesories, and more. 

See our weekly specials at our web site below.!! 


WCSC SUFI (800)966-4832 

6215 Longflower Ln Tel: (281)360-4232 

Kingwood, TX 77345 " JB ™“ Fax: (281)360-3231 
Internet: sales@wcscnet.com 

http://www.wcscnet.com 


The future is in your hands. 

# Red Hat Linux Boxed Set: $49.95 

mmm |\* ## Red l}at Linux 

T. % • 1 ^ "Power Tools" EL archives:'$29.95 

Rpplixware Office Suite for Linux: $99.95 
WWW • redhat ‘Com. Recl Hat s Motif for Linux: $149 

'Stab la-i Red Hat’s TriTeal CDE for Linux: $99.95 
ioperatin^sys^*^ Hat Securl Web Server: $99.95 

' \fedok S ; 

% LinUX Undercover: $39.95 

4-inux Complete Command Reference: $>-19.95 
Maximum RPM: $34.95 

Sf|§ll, v 

1. flaa.redhatl 1 . R1R . 547'. 0012 


'Sbffuare 'ftokcfic&C^ 


All the Extras You Need! 

WIBU-SYSTEMS has the optimal solution for network 
protection of software. 

A single WIBU-BOX for LPT, COM, USB,ADB, ISA and 
PCMCIA interfaces works in a network environment 
and offers theWIBU-KEY License Management feature. 
Profit from new ways of software distribution 
with WIBU-KEY! |■ftpgw 

Call Now forYour Free Test Kit 

(800) 986 6578 ® P 1 * 3 ®/ 

www.wibu.com 5S 


TECHNOLOGIES 

North and South America: 

Griffin Technologies, LLC 

1617 St. Andrews Drive, Lawrence. KS 66047 
Tel.: (785) 832-2070 • Fax.: (785) 832-8787 
Email: sales@griftech.com ■ www.griftech.com 


International 
WIBU-SYSTEMS AG 

Rueppurrer Strasse 54 
D-76137 Karlsruhe 
Tel.:+49-721-93172-0 
Fax: +49-721-93172-22 
Email: info@wibu.com 
http://www.wi bu .com 


UIBU 

SYSTEMS 


Quality the World Trusts 


— 


TE Edit Control (Advanced RTF control) 
HTML Viewer/Editor Add-on forTE 
ReportEase Plus (report writer engine) 
SpellTime DLL and dictionary 
Form Plus (form designer/filler) 

Rich Text Grid control and ChartPro 


INCLUDE COMPLETE 
SOURCE CODE, 
ARE ROYALTY FREE 
AND AVAILABLE FOR 


Demos: www.subsystems.com 


SUB SYSTEMS, INC. 

11 Tiger Row, Georgetown, MA 01833 
978-352-9020 Fax: 978-352-9019 









































































We Can Help! 

Attaining Microsoft Certification is no easy task. But the professional and 
financial rewards are worth it. Transcender exam simulations give you a 
realistic preview of the nature and difficulty of Microsoft certification 
exams. Our exams show you where you need to focus your studies and 
give you detailed explanations of every answer to every question. 


Where do you find 
116,000 
professional 
software developers 

monthly? 


NEW! developer pak $499 


(Includes Items 1,2, & choose TWO from 3-7 listed below) 

1. WinArch-l-Cert™ 2.0 (Windows Architecture I) -$149 

2. WinArch-ll-Cert™ 2.0 (Windows Architecture II)- $149 

3. VB-Cert™ 5.0 (Visual Basic 5.0) - $149 

4. VB-Cert™ 4.0 (VisualBasic4.0) - $129 

5. AccessCert™ 1.0 pieces 2.0; - $129 

6. AccessCert™ 7.0 (Access 7.0) - $129 

7. SQL-Cert 6.5 (SQL 6.5 Implementation) -$149 

To order, call 615-726-8779 , FAX 615-726-8884 

VISA/MC/AMEX/DISC/MO/COD Add $4 s&h ($25 outside the US) 

ONLINE ORDERING! 

T ransc ^?r 1A ft A ft A J 

242 Louise Ave. 

Nashville, TN 37203 


| Microsoft! 


Dr. Dobb's Electronic Review 
of Computer Books! 


♦ Independent reviews of technical computer books 

♦ Written BY developers FOR developers 


To order books in this magazine or, any book. Please call 24 hrs/365 days: (800) B00KS-N0W (266-5766) or 
(702) 258-3338 ask for ext. 1410 or visit us on the web at http://www.BooksNow.com/Dr.Dobbs. Use Visa, M/C, 
or AMEX or send check or money order + $4.95 S&H ($2.50 each add'l item) to: Books Now, 448E 6400 South, 
Ste. #125 Salt Lake City, UT 84107 


The Virtual Bookstore 


Do you need ODBC, OLE-DB, and JDBC access 
to a proprietary or legacy database? 


What does it take to get Microsoft Certified? 


OpenAccess™ odbcsdk 

is the quickest and most 
economical solution A 
for your needs! ME 


Call us! 

We would be happy to 
discuss your needs. 


Ask about 
our ODBC 
Drivers for 
commercial 


automation technology, inc. 
2890 Zanker Road, Suite 200 
San Jose, CA 95134 


Your solution 
will be ready 
for distribution 

in weeks. 


Tel 408/473.0200 
Fax 408/473.0201 


http://www.atlnet.com 
k sales@atinet.com 


MCSE exams 


www.ddj.com 
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ELOPMENT TOOLS 


Interactive Disassembler Pro 


Zip and Unzip from your apps with the 


interactive auto-commenting disassembler 
NOW WITH STANDARD LIBRARIES RECOGNITION I 
background analysis, unlimited size of input file 
EXE, NE, LE, PE, LX, NLM, Binary, ROM and more 
80x86, Pentium , Pentium Pro, MMX, Z80, 8051, 6502, 
68K, 680X, JAVA and more - still $199 + s&h 1 


Look to Inner Media for all of your ZIP/UNZIP 
development needs: 

DynaZIP is the industry leader for zip compatible 
royalty-free data compression. 

Active Delivery" is the answer when you want to add 
self-extracting zip file creation to your applications. 
All products have a full 30-day no risk guarantee. 

Inner Media, Inc. 

JimV' 60 Plain Road, Hollis, NH 03049 
(800) 962-2949 

(603) 465-3216, Fax (603) 465-7195 


• Easy to use VBX, OCX and VCLs 

• Fast, compact and reliable 

• Over 40 Zip and Unzip functions! 

• AIM 6 & 32-bit controls for $199.95 
New self-extractor add-on for Xceed Zip lets your 
apps create customized 16/32-bit self-extracting 
Zip files. Only $99 with purchase of Xceed Zip! 


Fast Library Intelligent Recognition Technology 
relegates classical disassembler technology into 
prehistory. Your disassemblies suddenly come alive 
and familiar symbols spring in sight. Get our free 
evaluation from 

www.datarescue.com or www.ccso.com 


Xceed Software 1-800-865-2626 1-514-442-2626 


The best cross-platform 
compression libraries 
for Win32, Win 16, 
\ DOS, OS/2, Unix, 

\ \ Macintosh, and 

embedded systems. 

Robust 45-function API compresses 
buffers, files, archives, disk spanning, 
encryption, self-extr. EXE's and more. 

FREE DEMO Call 1-800-775-1073 

rsm DC Micro Tel (606) 245-4175 

|£9 " Micro Fax j 606 j 245-9305 

S3 Development www.dcmicro.com 


Professional MTS & 
MSMQ with VB& ASP 


Bug and Feature Request Tracking Database 

Tracks 

bugs from initial report through final resolution 

Manages 

features from first request through implementation 

Organizes 

everything you need to create a top-quality product 

Sorts • Filters • Reports • Graphs • Exports 

your software development data the way you want it 

Nesbitt Software Corporation 

Download a FREE 30-day BugCollector trial from http://www.nesbitt.com/ 


This book covers everything you 
need to build secure, distributed 
applications with MTS and MSMQ- 
using DNA, components and queues, 


Author: Sussman & Homer. 1-861001-46-0 $39.99. 
Visit your local bookstore or view a full TOC and 
sample chapter at www.wrox.com. 
1-800-USE-WROX 


+ + COMPILERS 


CONSULTING 


Reduce Time to 
Market 

Over 100 years of 
Driver and Embedded Expertise 

Cross Platform Porting Experts 

Operating Systems: WinNT«Win95*Solaris«HP-UX»AIX»Unixware 
IRIX.Linux.SCO.VxWorks.pSOS 

ISDN.TCP/IP.ATM.ADSL.LAN.TTY.RPP.FDDI 
NDIS.STREAMS.DLPI.SS7.T1 /El .X25*Many more 
HW Platforms: x86.PPC.MIPS.SPARC-DSP.ISA.PCI.PCMCIA 
VME.PMC.CompactPCI.EISA.MicroChannel.H.100 

EMail: tcom@tcom-inc.com 
Web: http://www.tcom-inc.com 
Voice: 973-539-1777; ask for Jim 


Generate Documentation 
from your source code with DocJet 

Produce HTML, 

MSHelp, and 1 
MSWord 

documentation from 
comments in your 
code - and you won’t 
need to change your 
commenting style! i 


A Device Driver Technology Company 


You can fine- 
tune your output 
m with DocJet’s 
. WYSIWYG 
|l output editor. 


Drivers: 


FREE TRIAL VERSION! 

http://www.tall-tree.com 
info@tail-tree.com 512-453-4909 


+ + LIBRARIES 


html++ 

Product 

CGI Class Library 

Compatible with all internet web servers 
Generate interactive web pages in C+ + 
Ideal for webifying databases 
No more Perl or scripting 
Automates CGI, cookies, forms, state 
Win32, Winl 6, OS/2, DOS, Unix, Mac 

FREE DEMO Call 1 -800-775-1073 

Tel (606) 245-4175 
Fax (606)245-9305 
www.dcmicro.com 


3oost your programs into orbit' VB. QB, * < 

% C&Xbase libraries. Free demo disk f% 

& booklet - call now! info@teratech.com ^ 

* ProSSath/VB - numerics* ProBas - DOS libs ’ * 

* FinLib/VB - financial * SpellCheck/VB tp| 


W Code Co-op TM 

The first fully distributed version control system 

• No LAN or Central Server required. 

• Synchronization through e-mail. 

• Intuitive GUI - check-in, check-out, synch, difif. 

• Download the fully functional trial version 
from our web site. 

Reliable Software™ 

Smart Tools for Smart Programmers ™ 
http://www.relisoft.com info@relisoft.com 


telephony, math, web CF, ASP. Java. 


800 - 447-9120 x1338 

Dept 1338,100 Park Avenue, Suite 360, Rockville MD 20850 
lnfl:+1 -301424-3903 Fax:301-762-8185 BBS:301 -762-8184 

www.teratech.com/ddj/ 


Development 


Get the fully functional free trial version! 
www.xceedsoft.com/dobbs 


BugCollector Pro 2.0 

Puts Bugs In Their Place 


Professional 


Embedded 

Compilers 


http://www.cadul.com 


CAD-UL 


USA 

Ph. 602-945-8188 
us.sales@cadul.com 


GERMANY 
Ph. +49 731 93760-0 
sales@cadul.com 


UK 

Ph. +44-1291-626267 

uk.soles@cadul.com 































































































OCUMENTATiON TOOLS 


GRAPHICS LIBRARIES 


SECURITY 


^ ^New-Version 2.1. 

► Generates documen- 
a M M tation. directly from the 
source code. 

V ► Extracts comments. 

► User customized 
J I jb a reports formats. 

u m m i nl f ► HTML, WinFlelp, 

w M Ml i rf rtf. 

► FREE working 
evaluation at 

1-888-646-1933 www.bbeesoft.com 

Bumble Bee Software 

P.O.Box 2007 iWSmf 

Westford, MA 01886 / ^VS^H/ 

info@bbeesoft.com 


SciTech MGL is a complete graphics library for Windows 95/3.1/NT 
& DOS that has been used to develop leading titles like WnQuake® 
and Hexen II®. SciTech MGL can be ported to other OS’s in as few 
as 1000 lines of code. Includes: OpenGL® API support; sprite 
library; Game Framework; hardware triple buffering; support for 
stereo LCD shutter glasses; automatic detection & utilization of VGA, 
ModeX, VESA VBE, VBE/AF, WinG, CreateDIBSection & DirectDraw; 
and more. Supports standard C/C++compilers & Borland Delphi. 

For more information call ( 530 ) 894 - 8400 . 

Download SciTech MGL with full source code from our website at 


800-705-5552 

www.rainbow.com 


ADDRESS FOR SUCCESS 


http://www.aics.edu ^ 


SOFTWARE PROGRAMS 

M for partners in profit! 


Cost effective products for all 
levels of software protection 
and authentication. 

• CRYPTO-BOX® brand dongles, , 

SmartCard, PC Cards, and J 

extension cards " 

• Software based metering systems ^ 

• ActiveX, OCX & VCL components 


Earn B.S. and M.S. in Computer Science 

DISTANCE EDUCATION 

Object oriented B.S. program 

New courses in Java, Networking, HTML, MIS 

Approved by more than 275 companies 

Follows ACM/IEEE guidelines 

Thousands of students throughout U.S. 

Free catalogue 1-800-767-AICS 
or http://www.aics.edu. 


You provide the completed Small Business, SOHO, Financial 
or Personal Productivity software program. E-Z Legal 
Software will provide packaging, duplication, marketing and 
sales personnel to generate royalty checks for you. 
With distribution in more than 6500 retail outlets, we have 
the experience to launch, market and sell your program at retail 
at no cost 


AMERICAN 

INSTITUTT 

COMPUTER 

SCIENCES 


UNDA ZACK: 1-80Q-822-4566 X131 B^gl 


AWRY 

w SOFTWARE SECURITY 2! 


384 S. Military Trail, Deerfield Beach, FL 33442 
Phone (954) 480-8933 • Fax (954) 480-8901 

http://www.e-zlegal.com — lzack@e-zlegal.con 


Legal 


and Colleges 


Add Intelligent 
Components 


Add ANY FORM 
To Your Windows Application 

Speed 


Diagnose, advise, configure and plan IN4 
with the Amzi!® LogicServer™ tools & pSS 
libraries (DLLs) for C/C++, Java, VB, —I 
Delphi, Web Servers & more. Win NT w % 
95 3.x & Solaris. Use ODBC, Sockets, r m 
Unicode & new OOP extensions. 

FREE Evaluation Versionf jsjJjJ 

Amzi! inc. Ema//info@amzi.com jjjjs 
Cali +1-513-425-8050 Fax 425-8025 3* 


___ U P your software 

envelopment tbne ^ using Nalco's 
^^^^axtensiva form libraries & form creation services. 
• PCL, Placeabie Metafiles, PDF Formats • Field Format Information 
for Every Form • Sample Metafile Code in Visual Basic & Delphi • 
Government Approved Forms • Scan/barcoding Abilities 

VMt wr Strftwyt Pwtbwr'i Mt >« / . 

http://www.taxform8.eom/A.html J mlVGlCO 
Cal- 1-920-337-1013 ’ PO Bex 11288 

E-malb neicomktgenelcoinc.com. Brew Bey W1 >4387 


• Portable Embedded GUI 

• Small, fast, easily ported C ++ library 

• VGA, LCD, and input drivers included 

For full information and free demo: 

www.smxinfo.com/pegdd.htm 

MICRO DIGITAL INC 800-366-2491 
Innovation Leader 714-373-6862 


SECURITY 


IrypKey is software copy protection that is: 
completely secure from any disk copy program 
perfect for CD-ROM or INTERNET distribution! 
cost effective, user friendly, and 100% guaranteed 


SciTech MGL 

Now FREE with Full Source Code 


Seiurely Sell Your 
Software Worldwide 


Rainbow has software, hardware and 
Internet solutions to help developers 
■ Increase Sales 
u Expand Distribution 
u Prevent Piracy 


TOOLS 

Understand For C+ + 

I §1 Analyzes your C++ source code to help you 
quickly understand your software. 

• Hypertext source & Class Browser 

• Detailed Interactive Cross Reference 

• Invocation, Include, Declaration Heirarchy Charts 

• HTML Publishing of Code & Analysis 

• WYSIWYG printing, Clipboard & Bitmap Output 


Download your 
eval copy today. 
www.scitools.com 
(603) 448-6960 


Scientific Toolworks, Inc. 
115 Etna Road Suite 18A 
Lebanon, NH 03766 


CGI scripting is a piece of 
cake with Winduetor 2.1 


Easy and clear syntax 
Native to Windows 
Integrated debugging - 
canoe debugged with 
actual POSTed data from 
browser 


Use e-mail, FTP, HTTP, 
HTML-parsing and file I/O 
directly from the scripts 
Script and orchestrate 
other Windows programs 
Easy-to-follow CGI tutorial I 


Download your free 
evaluation copy today 


Winduc 


www.desison.com 2 Vernon St.#551,Framingham,MA01701 


smmb 


C and C++ DOCUMENTATION TOOLS (v. 7.0) 


• C-CALL ($69) Graphic-tree of caller/called function hierarchy, cross-reference, 
file/function index. 

• C-CMT ($69) Creates/inserts/updates comment-blocks (functions/identifiers 
used) for each function. 

• C-METRIC ($59) Calculates path complexity, counts lines with comments, code, 
'C statements. 

• C-LIST ($69) Lists and action-diagrams, or reformats source into user-selected 
standard fermats. 

• C-REF ($69) Creates cross-reference of local/global/define/parameter identifiers. 

• C-DOC ($199) PACKAGE All 5 programs integrated as DOS program. <10,000 
lines. C-BROWSE Windows graphic-tree viewer. 

• C-DOC Professional ($299) DOS, Windows, OS/2,1,000,000+ lines. 

» NEW VER 7.0! WEB HTML REPORTS! 

I SOFTWARE BLACKSMITHS INC. email @ swbsc ° m 
6064 St Ives Way, Mississauga Voice/Fax (905) 858-4466 
| ONT Canada L5N-4M1 http://www.swbs.com 


S3 S3 

VICTOR 


Image Processing Library 

Fast BMP, TIFF, PCX, GIF, TGA, PNG, JPEG. Adjust | 
brightness, contrast, sharpen, create filters, resize, rotate, 
+more of single image, multiple images, or any image area; 
color reduction to optimum, specific, or std. palette; print; 1 
scan; crop, combine, compare, blend images. 

DOS $199, 16-bit DLL $299, 32-bit DLL $499 
Catenary Systems 
314-962-7833/fax: 314-962-8037 
www.catenary.com/victor 
ask for free demo sre avail visa/mc/c.o.d. 


CrypKey Software Licensing System 

"Software protection with NO hardware lock and NO disk key" 


CrypKey can increase your software sales: 

• upsell options and levels of your software 

• lease or demo your software by runs or time 

• enable or upgrade your customers instantly by phone, fax or email! 

New! unique Ready-To-Try features upon install allows 1 trial period only per customer. 
New! unique Add-On feature-add more options, levels, runs or time to existing licenses. 
New! CrypKey Instant-protects in just 5 minutes with no source code changes. 
CrypKey is completely compatible with MS-DOS, MS-Windows 3.x, Win32s, Win95, Win NT, 
and manages network licenses on all Novell and Microsoft operating system based networks. 
CrypKey is produced by Kenonic Controls Ltd.—engineering and software since 1972. 

Kenonic Controls Limited 
7175 - 12th Street South East 
Calgary, Alberta, Canada T2H 2S6 
(403) 258-6200 fax: (403) 258 6201 
INTERNET: crypkey@kenonlc.com 
WEB: http://www.kenonic.com/crypkey.html 


Java & C++Training i // 

for Developers Who Need to Deliver // / 


■ Ultimate Java Programming 

■ Advanced Java Programming 

■ C++ Programming ., 

a Object Oriented Analysis & Design 

PETRONIOSa 

Technology Group 

781 - 778-2000 
FREE Java Quick Reference Card 


www.petronio.com/refddj 





















































































SWAINE'S FLAMES 


< 



The Dublin Corps 


I was loosening tongues with alcohol, working the late bartending shift at Foo Bar, the Silicon 
Valley hangout where the elite meet to be indiscreet. I had just poured British journalist 
Laurence Wilde his first glass of Chardonnay of the evening and refilled Maureen McBean’s 
Haig & Haig. Joe Weaver hadn’t come in yet. 

Joe was under no obligation to hang out with Larry and Mo, I reminded myself, but I was so 
used to seeing the three journalists together that I had come to think of them as the Three 
Stooges. When one of them was tardy, there was a certain ineffable ye nesais quoi missing from 
the eye gouging and the head thumping. 

“This might interest you, Mo,” Larry said with lamentable civility. (Lamentable from my point of 
view, that is. I only moonlight at Foo Bar for the entertainment value.) 

Just then, Joe walked in. My spirits rose, but fell immediately. Clamped between his teeth was 
an enormous cigar. Foo Bar is a no-smoking establishment. I’d have to put on my enforcer hat. 
“What’s with the stogie, Joe?” Mo asked, swiveling on her bar stool. 

He sat and held the thing out admiringly between two fingers. “All the cool people are into cigars.” 

I plunked his customary cream soda down in front of him. “Joe—” 

But he was on a roll. “Cigar parlors are the hot thing now. Tom Cruise and Arnold 
Schwartzeneg...” 

Larry pushed the peanut dish in Joe’s direction. “Positively fascinating, Joe. By the way, you 
might find this interesting—” 

“...are big cigar smokers. I don’t mean they smoke big cigars, although they might....” 

I tried to cut in. “You know, Joe, we have a policy —” 

“I’ve been asked to participate in the Dublin Core evaluation,” Larry went on doggedly, intent 
on getting his point across. Joe turned toward me, smiling blandly, but Larry had caught Mo’s 
attention. 

As I wrangled with Joe over the cigar issue, I half-listened to Larry and Mo. From what I could 
hear, they were no more than half-listening to each other. 

“The Dublin Corps, huh?” Mo said. “You know my family is Irish.” 

“There’s quite an alphabet soup of schemes for facilitating search in electronic documents—XML, 
XSL, RDF. It’s positively dizzying keeping them straight. The Dublin Core is just one of them.” 

“A Brit would say that. It’s not just one of them. It’s the most important one. It’s our island.” 
Larry pressed on. I was explaining to Joe that there is no cigar exemption to the California 
smoking ban, whatever he may have heard. “But the Dublin Core initiative,” Larry said, “has 
already produced international consensus on a base set of 15 elements for descriptive metadata.” 

Mo pushed her glass at me and mimed refilling it. “Okay, George Mitchell has done wonderful 
work with the peace negotiations, but, Larry, you can’t expect people to forget centuries of 
oppression. You Brits have got to get that through your heads.” 

“And it appears that the big guns at W3C are receptive to the DC proposals.” 

“Guns in the WC? You Limeys are such hoodlums.” 

“The 15 elements are already more or less supported in HTML 4. That is, meta tags in HTML 4 
are underspecified. You clarify them by including a reference to a profile, a URL of a document 
that defines useful properties for meta tags. Dublin Core is one such profile.” 

Mo stared at him with the expression of a woman who has just awakened and found a 
reference librarian in her bed. “What the heck are you talking about?” 

“The Dublin Core. The 15 metadata elements. Title, subject, description, source, language, 
relation, coverage, creator, publisher, contributor, rights, date, type, format, and identifier.” She 
continued to stare at him for a moment and then turned to Joe. “Joe, you can’t smoke that in 
here,” she said, and took the cigar and crushed it on a coaster. 

“But I wasn’t going to smoke it,” Joe wailed. “I just have it because cigars are the in thing.” 

The heck with these clowns. I’m going to run off and join the Dublin Corps. You can, too, at 
http://purl.org/metadata/dublin_core/. 



Michael Swaine 

editor-at-large 

mswaine@swaine.com 
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Discover CodeBase, the fastest and smallest database 
engine on the market that’s also XBASE file compatible. 
Query a million record table in 0.49 seconds or 
append ten thousand records in just 0.65 seconds! 


Now Available 


• Windows CE - Add powerful database 
capabilities to your applications with 
only 150K overhead, using our special 
Windows CE version. 


• ODBC - Combine the power of CodeBase 
and SQL with ADO, JDBC, VB, ... 


• OLE DB Support - Get superior client/ 
server performance, with standards- 
based C++ programming. 


• BDE Replacement - Lets you use 
CodeBase with any Delphi control. 


.*,*** 


.jm** 




ADVISOR ADVISOR ADVISOR ADVISOR 


Award-Winning performance 5 


Client/Server 


SEQUITER*! 

***** unTJ 


• Enhanced security features including 
built-in Internet firewall. 


• New easy-to-use tools for monitoring 
database activity and managing user 
access. 


• Easy installation and setup. 


Check out these features... 


“CodeBase gives ACT! the fast database access that contact management users need. ” 

- Michael Plasterer, Director of Development, Symantec 


• Works with C, C++, Visual Basic, Delphi and Java. 

• FoxPro, dBASE and Clipper file compatible, including full 
multi-user compatibility. 

• Runs under Windows 95, NT, CE, 3.1, DOS, Mac, OS/2, 
Solaris, SunOS, AIX, SCO, Linux, UnixWare, DEC, Alpha, 
HP/UX, ... 

• Scalable from stand-alone to client/server, without code 
changes. 

• Transaction processing and logging. 

• Full featured Report Designer included for free. 


FREE 30 Day Test Drive 

Test drive the new CodeBase 6 for 30 days with your own code 
No risk. No obligation. No Royalties. Order today! 

Call: 403-437-2410 



SOFTWARE INC 


Fax:403-436-2999 Email: info@sequiter.com 
P.O. Box 783, Greenland, NH 
In Europe call: (44) 181-3 16-5001 


Web Site: www.sequiter.com 


) 1998 Sequiter Software Inc. All rights reserved. CodeBase and Sequiter are registered trademarks of Sequiter Software Inc. All other product names are trademarks of their respective companies. 



















Wsua/Cafe 


WHatthe true^pr 
professionals drive. 

Fast. Flexible. And fully loaded. 


Symantec’s Visual Cafe for Java is 
the #l-seiling Java development solu¬ 
tion. New Version 2.5 combines 
state-of-the-art Java technology with 
the flexibility to work the way you 
want to. So you’ll cross the 
finish line in a fraction of the 
time. Try it today! 



The world’s #l-seUifig Jaxa IDE! 

m Fastest Java compiler speeds your application development 

■ State-of-the-art technologies help race you through tedious debugging 

■ JIT 3.0 provides the fastest JIT performance available 

■ Customizable work environment, with intuitive user interface and 
macroTgrogrammable" editor, lets you work the way you want to 

■ Open environment lets you integrate your favorite tools, such as 
CASE an<J Source Code Management 


FREE TE$T-DRIVE! 

Download a free trial version: 
http://cafe.symantec.com 

Or, call for a free test-drive CD 

1 - 888 - 822-3409 


■ Native x86 compilation satisfies your fast run requirements 

■ 100% pure Java code ensures cross-platform portability 

Symantec’s Visual Cafe for Java is the most robust, productive, 
solution for building enterprise-ready applications with Java! 
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INTERNET PROGRAMMING 


Rendering 
XML Documents 
Using XSL 


Keeping content 
and format separate 

Sean McGrath 

C entral to the extensible Markup Lan¬ 
guage (XML) philosophy is that the 
structure and content of information 
should be captured without concern 
for how the information will be rendered 
on a computer display, paper, voice syn¬ 
thesis, and others. Responsibility for ren¬ 
dering XML has been delegated to a sis¬ 
ter standard known as extensible Style 
Language (XSL). (For more information 
on XML, see my article “XML Program¬ 
ming in Python,” DDJ , February 1998.) 

Like XML, XSL is a World Wide Web 
Consortium (W3C) initiative. In August of 
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.html). Although, the working draft for 
XSL is just that, a number of XSL appli¬ 
cations have already appeared. In partic¬ 
ular, Microsoft has released MSXSL, a 
“technology preview” implementation that 
is freely available at http://www.mi- 
crosoft.com/xml/. In this article, I will pre¬ 
sent an overview of XSL and illustrate how 
it can be used with MSXSL. 



pens late — preferably right at the point 
that someone wants to view it (hence, 
late binding). 

This late binding approach has some 
significant benefits: 

• The look and feel of a document (or 
thousands of documents) can easily 
be changed simply by changing the 
stylesheet. 

• Multiple renditions of the same content 
can be created from a single source. 
These renditions can include different 
output notations such as RTF, HTML, or 
Postscript. They can involve rearrange¬ 
ments of the content, creating multiple 
views of the information. 

• The information content is “future 
proofed.” Creating a new rendition to a 
new notation (or a notation yet to be 
invented), is a matter of applying the 
necessary stylesheet. 

• Keeping the content free of rendering 
information makes it easier to process 
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Application Development Tools 
"We initially coded algorithms in 
Matlab and then converted the 
Matlab source to C or C++* To our 
surprise, the Matlab code was 
faster in nearly all cases." 

Jack Staub 
Hughes Aircraft 
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Interactive GUI Design 
"In one day, I wrote 875 lines of 
Matlab which equates to 5,000 
lines of C code. I had a functioning 
GUI in one day. You can't do that 
with C." 

Kathleen Splaine 
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We wrote exactly 
698,794 lines of C 
code so that you 
don’t have to. 

More than 400,000 engineers and scientists use Matlab 
to accelerate their technical programming. Here’s why. 


Faster programming 

Today’s most productive technical 
professionals have one thing in 
common - they use Matlab instead 
of C or C++. Because, unlike a 
general purpose language, 

Matlab is a complete, 
integrated analysis, visual¬ 
ization, modeling, and devel¬ 
opment environment specifically 
designed for technical computing. 
So development goes much faster 
and code is dramatically shorter. 

More numerical power built in 

At the heart of Matlab is an easy to 
learn technical computing language 
with more than 500 functions built 
in. The Matlab language includes 
flow control, multidimensional 


arrays, user-defined structures, 
ASCII and binary external data file 
access, and much more. And you’ll 
save even more time with Matlab 
Toolboxes, collections of highly 
optimized, discipline- 
specific functions written 
by world-class experts. 
You can even link in C, 
C++, and Fortran routines. 

Less time coding means more 
time to think 

Put simply, use Matlab and it will 
take you far less time to develop 
finely tuned applications with 
revealing graphics, custom GUIs, 
and compact maintainable code. 
Now just imagine what you can do 
with the time you save. 
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See how Matlab 5 can help you work faster. Visit our 
Web site for demos, examples, and updating information. 


























































With JDK 1.1-based browsers, this re¬ 
striction does not apply if the applet is 
signed. 

Oracle Connection Manager may be de¬ 
ployed in combination with JDBC applets 
to provide secure access to Oracle envi¬ 
ronments. Connection Manager incorpo¬ 
rates a Net8 application proxy, which lets 
system administrators control how a con¬ 
nection request gets routed. Through the 
use of rules, requests may be filtered 
based on parameters such as: 

• Destination or Origin IP address. 

• Oracle System Identifier (SID). 

• Data encryption/security preferences. 

The ThinJDBC applet can connect to a 
Connection Manager running on the Web¬ 
server host and have the Connection Man¬ 
ager redirect the packets to an Oracle serv¬ 
er running on a separate host. 

Fast Forward 

FastForward, a Type IV driver from Con¬ 
nect Software, provides Java clients with 
direct access to Microsoft SQL Server (all 
versions) and Sybase SQL Servers (Ver¬ 
sions 4, 9, 10, and 11). FastForward works 
by directly transferring and receiving in¬ 
formation from Java to SQL Server using 
TCP/IP sockets. The format of data 
passed back and forth is TDS. Version 
3.0 offers features such as xencryption 
and HTTP tunneling through the Fast- 
Forward Security Proxy. FastForward 
Proxy is a pure Java application that pro¬ 
vides connectivity between clients on the 
Internet and servers within your network. 
It also provides HTTP tunneling, com¬ 
pression, and encryption. Proxy uses sym¬ 
metric private key encryption in 16 


rounds with 64-bit key for encryption. It 
also supports DES. 

OPENjdbc 

OPENjdbc is I-Kinetics CORBA-based 
Type III driver. The driver communicates 
to the DataBroker server through HOP 
protocol. The databroker server is based 
on CORBA, using Iona’s Orbix Object Re¬ 
quest Broker to provide features such as 
multithreading, connection pooling, and 
load balancing. OPENjdbc invokes meth¬ 
ods and services defined in the DataBro- 
ker’s IDL files. Figure 3 illustrates the 
OPENjdbc architecture. 

OPENjdbc driver offers security features 
such as SSL encryption and authentication 
(through Orbix SSL) and HTTP tunneling 
of HOP. The SSL option is provided 
through Orbix SSL, which allows Orbix- 
and Orbix-Web-based applications to be 
easily retrofitted with SSL security. Orbix 
SSL replaces the default HOP protocol with 
the standardized SSL-IIOP protocol, which 
is essentially HOP over secure SSL con¬ 
nections. The SSL option provides au¬ 
thentication using public-key cryptogra¬ 
phy (RSA, DSS) and encryption using 
block-encryption methods (DES, RC4). 

The DataBroker server need not be on 
the same host as the web server that 
served the applet. An HOP proxy on the 
web server can route all requests to the 
databroker. Iona’s Wonderwall offers this 
feature along with its firewall features such 
as examination, filtering and logging of 
HOP requests, HTTP tunneling support, 
and ACL support. 

Conclusion 

Security is an important aspect of appli¬ 
cations that deal with sensitive data and 


are deployed on an open medium such 
as the Internet or an open intranet (no 
firewall). JDBC driver vendors offer tools 
which could meet the security needs of 
these applications. Your choice of soft¬ 
ware should be made based on factors 
such as application requirements, de¬ 
ployment configuration, security needs, 
expandibility, and standards supported by 
the vendor. 


For More Information 

WebLogic Inc. 

417 Montgomery Street 
San Francisco, CA 94104 
415-659-2600 

http://www.weblogic.com/ 

Intersolv Inc. 

9420 Key West Avenue 
Rockville, MD 20850 
301-838-5000 

http://www. intersolv.com/ 

Caribou Lake Software Inc. 
4780 Beacon Hill Road 
St. Paul, MN 55122 
612-688-9470 

http://www.cariboulake.com/ 

SCO 

425 Encinal Street 

P.O. Box 1900 

Santa Cruz, CA 95061-1900 

408-425-7222 

http://www.sco.com/ 

Sybase Inc. 

6475 Christie Avenue 
Emeryville, CA 94608 
510-922-3555 
http://www.sybase.com/ 

Oracle Corp. 

500 Oracle Parkway 
Redwood Shores, CA 94065 
650-506-7000 
http://www.oracle.com/ 

Connect Software Inc. 
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OPENGL 


Listing One 

typedef struct 

{ 

float x, y. z; /* coordinates */ 

) make_vertex_list; 

Listing Two 

typedef struct 

C 

int a, b, c; /* array indices */ 

int a_s, a_t, /* (s, t) texture coordinates */ 

b_s, b_t, 

c_s, c_t; 

) make_index_list; 

Listing Three 

(a) 

(vertex_list[index_list[0].a].x, vertex_list[index_list[0].a].y, 

vertex_list[index_list[0].a].z) 

(b) 

(vertex_list[index_list[0].b].x, vertex_list[index_list[0].b].y, 

vertex_list[index_list[0].b].z) 

(c) 

(vertex_list[index_list[0].c].x, vertex_list[index_list[0].c].y, 

vertex_list[index_list[0].c].z) 

Listing Four 

typedef struct 

{ 

make_vertex_list ^vertex; 

) make_frame_list; 


/* use the OpenGL function to rescale */ 

gluScalelmage (GL.RGBA, m_iWidth, m_iHeight, GL_UNSIGNED_BYTE, unScaled, 

m_iscaledWidth, m_iscaledHeight, GL_UNSIGNED_BYTE, glTexture) 

/* reclaim memory of the unsealed texture */ 
delete [] unScaled; 


TEXTURE MAPPING 


Listing One 

void Draw_Triangle(float x0,float y0,float xl,float yl, 

float x2,float y2, int color) 

{ 

// this function rasterizes a triangle with a flat bottom 

// compute left side interpolant 
float dx_left = (x2 - x0)/(y2 - y0); 

// compute right side interpolant 
float dx_right = (xl - x0)/(y2 - y0); 

// seed left and right hand interpolators 
float x_left = x0; 
float x_right = x0; 

// enter into rasterization loop 
for (int y=y0; y<=yl; y ++ ) 

( 

// draw the scanline 

Draw_Line(x_left, x_right, y, color); 

// advance interpolants 
x_left+=dx_left; 
x_right+=dx_right; 

) // end for y 
} // end Draw_Triangle 


Listing Five: 

(a) 

frame_list[F].vertex[index_list[P].a].x 
frame_list[F].vertex[index.list[P].a].y 
frame.list[F].vertex[index.list[P].a].z 

(b) 

frame_list[F].vertex[index_list [P].b].x 
frame_list[F].vertex[index_list[P].b].y 
frame_list[F].vertex[index_list[P].b].z 


Listing Two 

// initialize u.v interpolants to left and right side values 
ui = ul; 
vi = vl; 

// now interpolate from left to right, i.e, in a positive x direction 
for (x = xstart; x <= xend; x++) 

C 

// get texture pixel value 
pixel = texture_map[ui][vi]; 


(c) 

frame_list[F].vertex[index_list[P].c].x 
frame_list[F].vertex[index_list[P]. c].y 
frame_list[F].vertex[index_list[P].c].z 

Listing Six 

(a) 

R: m_palette_buffer [ m_pixel_buffer[0]] 

G: m_palette_buffer [ m_pixel_buffer[1]] 

B: m_palette_buffer [ m_pixel_buffer[2]] 


// plot pixel at x.y 
Plot_Pixel(x,y,pixel); 

// advance u.v interpolants 

ui+=du; 

vi+=dv; 

) // end for x 


DVD 


(b) 

R: m_palette_buffer [3 
G: m_palette_buffer [3 
B: m_palette_buffer [3 


* m_pixel_buffer[P]+0] 

* m_pixel_buffer[P]+l] 

* m_pixel_buffer[P]+2] 


Listing One 

// grab an interface to the Annex J methods 

hr = m_pgraph->QueryInterface(IID_IDvdControl, (void **) &m_pUserOperations); 


(c) 

R: m_palette_buffer 
G: m_palette_buffer 
B: m_palette_buffer 


[3 * m_pixel_buffer[X + Y*Width]+0] 
[3 * m_pixel_buffer[X + Y*Width]+l] 
[3 * m_pixel_buffer[X + Y*Width]+2] 


if ( !(FAILED(hr)) ) 

( 

// start playing title 1. chapter 3 

hr = m_pUserOperations->ChapterPlay( 1,3); 


Listing Seven 

glPixelStorei(GL_UNPACK_ALIGNMENT, 1); 

glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP); 
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP); 
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); 
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST); 

Listing Eight 

glEnable(GL_CULL_FACE); 
glEnable(GL_TEXTURE_2D); 
glPolygonMode (GL_FRONT, GL_FILL); 


// view the 2nd angle 
m_pUserOperations->AngleChange( 2); 

// turn off annoying foreign language subtitles 
m_pUserOperations->SubpictureStreamChange( 1, FALSE ) 

// release interface 
m_pUserOperations->Release(); 


Listing Two 

switch (Event) 











INTERNET PROGRAMMING 


Rendering 
XML Documents 
Using XSL 


Keeping content 
and format separate 

Sean McGrath 

C entral to the extensible Markup Lan¬ 
guage (XML) philosophy is that the 
structure and content of information 
should be captured without concern 
for how the information will be rendered 
on a computer display, paper, voice syn¬ 
thesis, and others. Responsibility for ren¬ 
dering XML has been delegated to a sis¬ 
ter standard known as extensible Style 
Language (XSL). (For more information 
on XML, see my article “XML Program¬ 
ming in Python,” DDJ , February 1998.) 

Like XML, XSL is a World Wide Web 
Consortium (W3C) initiative. In August of 
1997, a draft proposal for XSL was made 
available as a discussion document by the 
W3C (http://www.w3.org/TR/NOTE-XSL 


Sean, chief technical officer and cofounder 
of Digitome Electronic Publishing (http:// 
www.digitome.com/) is a member of the 
World Wide Web Consortium’s XML Spe¬ 
cial Interest Group. He is also the author 
p/ParseMe.lst: SGML for Software Devel¬ 
opers (Prentice-Hall, 1997) and XML By 
Example: Building E-commerce Applica¬ 
tions (Prentice-Hall, 1998). Sean can be 
reached at sean@digitome.com. 


.html). Although, the working draft for 
XSL is just that, a number of XSL appli¬ 
cations have already appeared. In partic¬ 
ular, Microsoft has released MSXSL, a 
“technology preview” implementation that 
is freely available at http://www.mi- 
crosoft.com/xml/. In this article, I will pre¬ 
sent an overview of XSL and illustrate how 
it can be used with MSXSL. 



The XSL Philosophy 

As Figure 1 illustrates, the XSL philoso¬ 
phy can be summed up as “late binding 
of presentation semantics.” In simple En¬ 
glish, the idea is that information about 
how a document should look when ren¬ 
dered (presentation semantics) is sepa¬ 
rated from the document content and 
housed in a stylesheet. The process of 
creating a rendition of the content hap¬ 


pens late — preferably right at the point 
that someone wants to view it (hence, 
late binding). 

This late binding approach has some 
significant benefits: 

• The look and feel of a document (or 
thousands of documents) can easily 
be changed simply by changing the 
stylesheet. 

• Multiple renditions of the same content 
can be created from a single source. 
These renditions can include different 
output notations such as RTF, HTML, or 
Postscript. They can involve rearrange¬ 
ments of the content, creating multiple 
views of the information. 

• The information content is “future 
proofed.” Creating a new rendition to a 
new notation (or a notation yet to be 
invented), is a matter of applying the 
necessary stylesheet. 

• Keeping the content free of rendering 
information makes it easier to process 
the content. That is, searching, harvest¬ 
ing, or rearranging the content can be 
performed without worrying about how 
the formatting information is intermin¬ 
gled with the content. 

There are a number of core concepts 
that are central to XSL, including: 

Flow Objects. In XSL, the process of 
transforming an XML document into a 
notation such as RTF, HTML, or 
Postscript, is expressed in terms of the 
construction of flow objects, which are 
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Interactive GUI Design 
"In one day, I wrote 875 lines off 
Matlab which equates to 5,000 
lines of C code. I had a functioning 
GUI in one day. You can't do that 
with C." 

Kathleen Splaine 
Risk International 


Analysis and Visualization 
"Anything from simple analysis to 
complex modeling and simulation 
can be done in a fraction of the 
time it would take to write your 
own code." 

Gregory E. Chamitoff, Ph.D. 

NASA, Johnson Space Center 


We wrote exactly 
698,794 lines of C 
code so that you 
don’t have to. 


The MathWorks, Inc. 24 Prime Park Way, Natick, MA 01760 Fax 508-647-7001 
Employment opportunities: http://www.mathworks.com/newjobs.html 

The MathWorks is represented in the following countries: Australia: + 61-2-9922-6311 • Benelux: + 31(0)182-53-7644 • Brazil: + 55-11-816-3144 
Czech Republic: 42 (0)2-68-44-174 • France: 33-141-14-67-14 • Germany/Austria: + 49-241-470750 • India: + 91-80-5-549338 
Israel: + 972-3-561-5151 • Italy: + 39-11 -240-80-00 • Japan: + 81-3-5978-5410 • Korea: + 82-2-556-1257 • New Zealand: + 64-7-839-9102 
Nordic Countries: + 46-8-15-30-22 • Poland: + 48-126-17-33-48 • Singapore/Malaysia: + 65-842-4222 • South Africa: + 27-11-325-6238 
Spain/Portugal: + 34(9)3-415-49-04 • Switzerland: + 41-31-954-2020 • Taiwan: 886-2-505-0525 • United Kingdom/Ireland: + 44-1223-423-200 

© 1998 by The MathWorks, Inc. All rights reserved. MATIAB is a registered trademark of The MathWorks, Inc. Other product or brand names are trademarks or registered 
trademarks of their respective holders. 


More than 400,000 engineers and scientists use Matlab 
to accelerate their technical programming. Here’s why. 


Faster programming 

Today’s most productive technical 
professionals have one thing in 
common - they use Matlab instead 
of C or C++. Because, unlike a 
general purpose language, 

Matlab is a complete, 
integrated analysis, visual¬ 
ization, modeling, and devel¬ 
opment environment specifically 
designed for technical computing. 
So development goes much faster 
and code is dramatically shorter. 

More numerical power built in 

At the heart of Matlab is an easy to 
learn technical computing language 
with more than 500 functions built 
in. The Matlab language includes 
flow control, multidimensional 


arrays, user-defined structures, 
ASCII and binary external data file 
access, and much more. And you’ll 
save even more time with Matlab 
Toolboxes, collections of highly 
optimized, discipline- 
specific functions written 
by world-class experts. 
You can even link in C, 
C++, and Fortran routines. 

Less time coding means more 
time to think 

Put simply, use Matlab and it will 
take you far less time to develop 
finely tuned applications with 
revealing graphics, custom GUIs, 
and compact maintainable code. 
Now just imagine what you can do 
with the time you save. 
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See how Matlab 5 can help you work faster. Visit our 
Web site for demos, examples, and updating information. 


The 

MATH 

WORKS 


MATLAB’ 

www.mathworks.<om/ddjm 
call 508-647-7000 
e-mail info@mathworks.com 


Application Development Tools 

"We initially coded algorithms in 
Matlab and then converted the 
Matlab source to C or C++. To our 
surprise, the Matlab code was 
faster in nearly all cases." 

Jack Staub 
Hughes Aircraft 











































































With JDK 1.1-based browsers, this re¬ 
striction does not apply if the applet is 
signed. 

Oracle Connection Manager may be de¬ 
ployed in combination with JDBC applets 
to provide secure access to Oracle envi¬ 
ronments. Connection Manager incorpo¬ 
rates a Net8 application proxy, which lets 
system administrators control how a con¬ 
nection request gets routed. Through the 
use of rules, requests may be filtered 
based on parameters such as: 

• Destination or Origin IP address. 

• Oracle System Identifier (SID). 

• Data encryption/security preferences. 

The ThinJDBC applet can connect to a 
Connection Manager running on the Web¬ 
server host and have the Connection Man¬ 
ager redirect the packets to an Oracle serv¬ 
er running on a separate host. 

Fast Forward 

FastForward, a Type IV driver from Con¬ 
nect Software, provides Java clients with 
direct access to Microsoft SQL Server (all 
versions) and Sybase SQL Servers (Ver¬ 
sions 4, 9, 10, and 11). FastForward works 
by directly transferring and receiving in¬ 
formation from Java to SQL Server using 
TCP/IP sockets. The format of data 
passed back and forth is TDS. Version 
3.0 offers features such as xencryption 
and HTTP tunneling through the Fast- 
Forward Security Proxy. FastForward 
Proxy is a pure Java application that pro¬ 
vides connectivity between clients on the 
Internet and servers within your network. 
It also provides HTTP tunneling, com¬ 
pression, and encryption. Proxy uses sym¬ 
metric private key encryption in 16 


rounds with 64-bit key for encryption. It 
also supports DES. 

OPENjdbc 

OPENjdbc is I-Kinetics CORBA-based 
Type III driver. The driver communicates 
to the DataBroker server through HOP 
protocol. The databroker server is based 
on CORBA, using Iona’s Orbix Object Re¬ 
quest Broker to provide features such as 
multithreading, connection pooling, and 
load balancing. OPENjdbc invokes meth¬ 
ods and services defined in the DataBro- 
ker’s IDL files. Figure 5 illustrates the 
OPENjdbc architecture. 

OPENjdbc driver offers security features 
such as SSL encryption and authentication 
(through Orbix SSL) and HTTP tunneling 
of HOP. The SSL option is provided 
through Orbix SSL, which allows Orbix- 
and Orbix-Web-based applications to be 
easily retrofitted with SSL security. Orbix 
SSL replaces the default HOP protocol with 
the standardized SSL-IIOP protocol, which 
is essentially HOP over secure SSL con¬ 
nections. The SSL option provides au¬ 
thentication using public-key cryptogra¬ 
phy (RSA, DSS) and encryption using 
block-encryption methods (DES, RC4). 

The DataBroker server need not be on 
the same host as the web server that 
served the applet. An HOP proxy on the 
web server can route all requests to the 
databroker. Iona’s Wonderwall offers this 
feature along with its firewall features such 
as examination, filtering and logging of 
HOP requests, HTTP tunneling support, 
and ACL support. 

Conclusion 

Security is an important aspect of appli¬ 
cations that deal with sensitive data and 


are deployed on an open medium such 
as the Internet or an open intranet (no 
firewall). JDBC driver vendors offer tools 
which could meet the security needs of 
these applications. Your choice of soft¬ 
ware should be made based on factors 
such as application requirements, de¬ 
ployment configuration, security needs, 
expandibility, and standards supported by 
the vendor. 


For More Information 

WebLogic Inc, 

417 Montgomery Street 
San Francisco, CA 94104 
415-659-2600 

http;//www. weblogic.com/ 

Intersolv Inc. 

9420 Key West Avenue 
Rockville, MD 20850 
301-838-5000 

http ://www. intersolv. com/ 

Caribou Lake Software Inc. 

4780 Beacon Hill Road 
St. Paul, MN 55122 
612-688-9470 

http://www. cariboulake. com/ 
SCO 

425 Encinal Street 

P.O. Box 1900 

Santa Cruz, CA 95061-1900 

408-425-7222 

http://www.sco.com/ 

Sybase Inc. 

6475 Christie Avenue 
Emeryville, CA 94608 
510-922-3555 
http://www. Sybase . com/ 

Oracle Corp. 

500 Oracle Parkway 
Redwood Shores, CA 94065 
650-506-7000 
http://www.oracle.com/ 

Connect Software Inc. 

81 Lansing Street 

San Francisco, CA 94105 

415-543-6695 

http ://www. connectsw. com/ 
I-Kinetics Inc. 

17 New England Executive Park 
Burlington, MA 01803 
781-270-1300 
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Figure 5: The OPENjdbc client (client behind firewall, client outside a firewall) 

accessing DataBroker server where server is behind Wonderwall DDJ 
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OPENGL 


Listing One 

typedef struct 

C 

float x, y, z; /* coordinates */ 

} make_vertex_list; 

Listing Two 

typedef struct 

{ 

int a, b, c: /* array indices */ 

int a_s, a_t, /* (s, t) texture coordinates */ 

b_s. b_t, 

c_s, c_t; 

) make_index_list; 

Listing Three 

(a) 

(vertex_list[index_list[0].a].x, vertex_list[index_list[0].a].y, 

vertex_list[index_list[0].a].z) 


(b) 

(vertex_list[index_list[0].b].x, 


vertex_list[index_list[0].b].y, 

vertex.list[index_list[0].b].z) 


(c) 

(vertex_list[index_list[0].c].x, vertex.list[index.list[0].c].y. 

vertex_list[index_list[0].c].z) 


/* use the OpenGL function to rescale */ 

gluScalelmage (GL_RGBA, m_iWidth, m_iHeight, GL_UNSIGNED_BYTE, unScaled, 

m.iscaledWidth, m_iscaledHeight, GL_UNSIGNED_BYTE, glTexture); 

/* reclaim memory of the unsealed texture */ 
delete [] unScaled: 


TEXTURE MAPPING 


Listing One 

void Draw_Triangle(float x0,float y0,float xl,float yl, 

float x2,float y2, int color) 

C 

// this function rasterizes a triangle with a flat bottom 

// compute left side interpolant 
float dx_left = (x2 - x0)/(y2 - y0); 

// compute right side interpolant 
float dx_right = (xl - x0)/(y2 - y0); 

// seed left and right hand interpolators 
float x_left = x0; 
float x_right = x0; 

// enter into rasterization loop 
for (int y=y0; y<=yl; y ++ ) 

( 

// draw the scanline 
Draw_Line(x_left, x_right, y, color): 


Listing Four 

typedef struct 

{ 

make_vertex_list *vertex; 
} make_frame_list; 


// advance interpolants 
x_left+=dx_left; 
x_right+=dx_right: 

} // end for y 
) // end Draw_Triangle 


Listing Five: 

(a) 

frame_list[F].vertex[index_list[P].a].x 
frame.list[F].vertex[index_list[pj.a].y 
frame_list[F].vertex[index_list[P].a].z 

(b) 

frame_list[F].vertex[index.list[P].b].x 
frame_list[F].vertex[index_list[P].b].y 
frame_list[F].vertex[index_list[P].b].z 


Listing Two 

// initialize u,v interpolants to left and right side values 
ui = ul; 
vi = vl; 

// now interpolate from left to right, i.e, in a positive x direction 
for (x = xstart; x <= xend; x++) 

( 

// get texture pixel value 
pixel = texture_map[ui][vi]; 


(c) 

frame.list[F].vertex[index_list[P].c].x 
frame_list[F].vertex[index_list[P].c].y 
frame_list[F].vertex[index_list[P].c] .z 

Listing Six 

(a) 

R: m_palette_buffer [ m_pixel_buffer[0]] 

G: m_palette_buffer [ m_pixel_buffer[1]] 

B: m_palette_buffer [ m_pixel_buffer[2]] 


// plot pixel at x.y 
Plot_Pixel(x,y,pixel); 

// advance u,v interpolants 
ui+=du: 
vi+=dv; 

) // end for x 


DVD 


(b) 

R: m_palette_buffer [3 
G: m_palette_buffer [3 
B: m_palette_buffer [3 


* m_pixel_buffer[P]+0] 

* m_pixel_buffer[P]+l] 

* m_pixel_buffer[P]+2] 


Listing One 

// grab an interface to the Annex J methods 

hr = m_pgraph->QueryInterface(IID_IDvdControl, (void **) &m_pUserOperations); 


(c) 

R: m_palette_buffer 
G: m_palette_buffer 
B: m_palette_buffer 


[3 * m_pixel_buffer[X + Y*Width]+0] 
[3 * m_pixel_buffer[X + Y*Width]+l] 
[3 * m_pixel_buffer[X + Y*Width]+2] 


if ( !(FAILED(hr)) ) 

C 

// start playing title 1, chapter 3 

hr = m_pUserOperations->ChapterPlay( 1, 3 ); 


Listing Seven 

glPixelStorei(GL_UNPACK_ALIGNMENT, 1): 

glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP); 
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP); 
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST); 
glTexParameteri(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GLJNEAREST); 

Listing Eight 

glEnable(GL_CULL_FACE); 
glEnable(GL_TEXTURE_2D); 
glPolygonMode (GL_FRONT, GL_FILL); 

glTexEnvf(GL_TEXTURE_ENV, GL_TEXTURE_ENV_MODE, GL_DECAL): 

Listing Nine 

Glubyte *unScaled = new GLubyte [m_iWidth * m_iHeight * 4]; 
for (j = 0: j < m_iHeight; j++) { 
for (i = 0; i < m_iWidth; i++) { 
unScaled [4* (j * m_iWidth + i)+0] = 

(GLubyte) m_palette_buffer[3*m_pixel_buffer[j*m_iWidth+i]+0] 
unScaled [4* (j * m_iWidth + i)+l] = 

(GLubyte) m_palette_buffer[3*m_pixel_buffer[j*m_iWidth+i]+1] 
unScaled [4* (j * m_iWidth + i)+2] = 

(GLubyte) m_palette_buffer[3*m_pixel_buffer[j*m_iWidth+i]+2] 
unScaled [4* (j * m_iWidth + i)+3] = (GLubyte) 255; 


Listing Ten 

/* allocate memory for the new rescaled texture */ 

glTexture = new GLubyte [m_iscaledWidth * m_iscaledHeight * 4]; 


// view the 2nd angle 
m_pUserOperations->AngleChange( 2); 

// turn off annoying foreign language subtitles 
m_pUserOperations->SubpictureStreamChange( 1, FALSE ); 

// release interface 
m_pUserOperations->Release(); 


Listing Two 

switch (Event) 

C 

case EC_DVD_BUTTON_CHANGE : 

// lParaml contains number of active buttons 

//if there are ANY buttons alive—enable button manipulation 

if ( lParaml > 0 ) 

C 

bActiveButtons = TRUE; 

) 

break; 

case EC_DVD_ANGLE_CHANGE : 

// lParaml contains the current viewing angle 

break; 

case EC_DVD_TITLE_CHANGE : 

// lParaml contains the currently playing title 
break; 

case EC_DVD_CHAPTER_START : 

// lParaml contains the currently playing chapter 
break; 

case EC_DVD_VALID_UOPS_CHANGE : 

// lParaml contains the currently active user operations 
break; 

} 
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